프롬프트 플로우의 노드 유형

모든 프롬프트 흐름에는 흐름 입력 노드가 하나만 포함되며 이 노드로 시작해야 합니다. 흐름 입력 노드는 content InvokeFlow 요청에서 데이터를 가져와 데이터 유형을 검증한 후 다음 노드로 보냅니다.

다음은 에 있는 입력 FlowNode개체의 일반적인 구조를 보여줍니다. API

{
    "name": "string",
    "type": "Input",
    "outputs": [
        {
            "name": "document",
            "type": "String | Number | Boolean | Object | Array",
        }
    ],
    "configuration": {
        "input": CONTEXT-DEPENDENT
    }
}

흐름 출력 노드는 정의된 표현식을 기반으로 이전 노드에서 입력 데이터를 추출하여 반환합니다. 콘솔에서는 테스트 창에서 Run을 선택한 후 반환되는 응답이 출력됩니다. 에서는 InvokeFlow 응답의 content flowOutputEvent 필드에 출력이 반환됩니다. API 프롬프트 흐름에는 흐름 출력 노드가 여러 개 있을 수 있습니다.

흐름에 여러 분기가 있는 경우 흐름에 흐름 출력 노드가 여러 개 있을 수 있습니다.

다음은 출력 FlowNode개체의 일반적인 구조를 보여줍니다.

{
    "name": "string",
    "type": "Output",
    "inputs": [
        {
            "name": "document",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        }
    ],
    "configuration": {
        "output": CONTEXT-DEPENDENT
    }
}

조건 노드는 정의된 조건에 따라 이전 노드의 데이터를 다른 노드로 보냅니다. 조건 노드는 여러 입력을 받을 수 있습니다.

예시는 조건 노드를 사용하여 흐름 생성에서 확인하십시오.

조건 표현식

조건을 정의하려면 다음 관계 연산자 중 하나를 사용하여 입력값을 이름으로 참조하고 값과 비교합니다.

입력값을 다른 입력값이나 조건부 표현식의 상수와 비교할 수 있습니다. 예를 들어 숫자 입력값이 profit 호출되고 다른 입력값이 호출된 경우 profit > expenses profit <= 1000 둘 다 유효한 표현식입니다. expenses

다음 논리 연산자를 사용하여 보다 복잡한 조건의 표현식을 결합할 수 있습니다. 표현식 그룹화의 모호성을 해결하려면 괄호를 사용하는 것이 좋습니다.

API에서는 CreateFlow또는 UpdateFlow요청을 보낼 때 definition 필드에 다음을 정의합니다.

이터레이터 노드는 배열을 가져와 해당 항목을 반복적으로 다운스트림 노드에 출력으로 반환합니다. 이터레이터 노드에 대한 입력은 하나씩 처리되며 서로 병렬로 처리되지 않습니다. 흐름 출력 노드는 각 입력에 대한 최종 결과를 서로 다른 응답으로 반환합니다. 반복자 노드의 다운스트림에 있는 컬렉터 노드를 사용하여 반복된 응답을 수집하여 배열 크기와 함께 배열로 반환할 수도 있습니다.

다음은 이터레이터 객체의 일반 구조를 보여줍니다. FlowNode

{
    "name": "string",
    "type": "Iterator",
    "inputs": [
        {
            "name": "array",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "arrayItem",
            "type": "String | Number | Boolean | Object | Array",
        },
        {
            "name": "arraySize",
            "type": "Number"
        }
    ],
    "configuration": {
        "iterator": CONTEXT-DEPENDENT
    }
}

컬렉터 노드는 배열의 크기 외에도 반복된 입력을 받아 배열로 반환합니다. 이터레이터 노드의 다운스트림에 있는 컬렉터 노드를 사용하여 일부 노드를 통해 이터레이션된 항목을 전송한 후 해당 항목을 수집할 수 있습니다.

다음은 컬렉터 객체의 일반 구조를 보여줍니다. FlowNode

{
    "name": "string",
    "type": "Collector",
    "inputs": [
        {
            "name": "arrayItem",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        {
            "name": "arraySize",
            "type": "Number"
        }
    ],
    "outputs": [
        {
            "name": "collectedArray",
            "type": "Array"
        },
    ],
    "configuration": {
        "collector": CONTEXT-DEPENDENT
    }
}

프롬프트 노드는 흐름에서 사용할 프롬프트를 정의합니다. 프롬프트 관리의 프롬프트를 사용하거나 노드에 인라인 하나를 정의할 수 있습니다. 자세한 내용은 Amazon Bedrock에서 프롬프트 관리를 사용하여 재사용 가능한 프롬프트 생성 및 저장 단원을 참조하십시오.

예시는 예제 프롬프트 흐름 시작하기에서 확인하십시오.

프롬프트 노드의 입력은 변수를 채울 값입니다. 출력은 모델에서 생성된 응답입니다.

다음은 프롬프트 FlowNode객체의 일반적인 구조를 보여줍니다.

{
    "name": "string",
    "type": "prompt",
    "inputs": [
        {
            "name": "content",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        ...
    ],
    "outputs": [
        {
            "name": "modelCompletion",
            "type": "String"
        }
    ],
    "configuration": {
        "prompt": {
            "sourceConfiguration": PromptFlowNodeSourceConfiguration object (see below)
        }
    }
}

PromptFlowNodeSourceConfiguration객체는 프롬프트 관리의 프롬프트를 사용하는지 아니면 인라인으로 정의하는지에 따라 달라집니다.

에이전트 노드를 사용하면 에이전트에 프롬프트를 보낼 수 있습니다. 에이전트는 관련 리소스 간에 FMs 오케스트레이션하여 최종 사용자를 식별하고 해당 작업을 수행합니다. 자세한 내용은 대화형 에이전트를 사용하여 애플리케이션에서 작업 자동화 단원을 참조하십시오.

구성에서 사용할 에이전트 별칭의 Amazon 리소스 이름 (ARN) 을 지정합니다. 노드에 입력되는 내용은 에이전트에 대한 프롬프트와 모든 관련 프롬프트 또는 세션 속성입니다. 노드는 에이전트의 응답을 출력으로 반환합니다.

다음은 에이전트 FlowNode개체의 일반 구조를 보여줍니다.

{
    "name": "string",
    "type": "Agent",
    "inputs": [
       {
            "name": "agentInputText"
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        {
            "name": "promptAttributes"
            "type": "Object",
            "expression": "string"
        },
        {
            "name": "sessionAttributes"
            "type": "Object",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "agentResponse",
            "type": "String"
        }
    ],
    "configuration": {
        "agent": {
            "agentAliasArn": "string"
        }
    }
}

지식창고 노드를 사용하면 지식창고에 쿼리를 보낼 수 있습니다. 자세한 내용은 지식 베이스로 데이터 검색 및 AI 응답 생성 단원을 참조하십시오.

구성에서 검색된 결과를 기반으로 응답을 생성하려는 경우 사용할 지식 기반 ID와 모델 ID를 제공하십시오. 검색된 결과를 배열로 반환하려면 모델 ID를 생략하십시오. 노드에 입력되는 내용은 지식 베이스에 대한 쿼리입니다. 출력은 모델 응답 (문자열) 이거나 검색된 결과의 배열입니다.

다음은 지식 기반 FlowNode개체의 일반적인 구조를 보여줍니다.

{
    "name": "string",
    "type": "KnowledgeBase",
    "inputs": [
       {
            "name": "retrievalQuery",
            "type": "String",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "retrievalResults",
            "type": "Array | String"
        }
    ],
    "configuration": {
        "knowledgeBase": {
            "knowledgeBaseId": "string",
            "modelId": "string"
        }
    }
}

S3 스토리지 노드를 사용하면 Amazon S3 위치로의 흐름에 데이터를 저장할 수 있습니다. 구성에서 데이터 스토리지에 사용할 S3 버킷을 지정합니다. 노드에 입력되는 항목은 저장할 콘텐츠와 객체 키입니다. 노드는 S3 위치를 출력으로 반환합니다. URI

다음은 S3 스토리지 FlowNode객체의 일반 구조를 보여줍니다.

{
    "name": "string",
    "type": "Storage",
    "inputs": [
        {
            "name": "content",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        {
            "name": "objectKey",
            "type": "String",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "s3Uri",
            "type": "String"
        }
    ],
    "configuration": {
        "retrieval": {
            "serviceConfiguration": {
                "s3": {
                    "bucketName": "string"
                }
            }
        }
    }
}

S3 검색 노드를 사용하면 Amazon S3 위치에서 데이터를 검색하여 흐름에 도입할 수 있습니다. 구성에서 데이터를 검색할 S3 버킷을 지정합니다. 노드에 입력되는 것은 객체 키입니다. 노드는 S3 위치의 콘텐츠를 출력으로 반환합니다.

다음은 S3 검색 FlowNode객체의 일반 구조를 보여줍니다.

{
    "name": "string",
    "type": "Retrieval",
    "inputs": [
        {
            "name": "objectKey",
            "type": "String",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "s3Content",
            "type": "String"
        }
    ],
    "configuration": {
        "retrieval": {
            "serviceConfiguration": {
                "s3": {
                    "bucketName": "string"
                }
            }
        }
    }
}

Lambda 함수 노드를 사용하면 비즈니스 로직을 수행하는 코드를 정의할 수 있는 Lambda 함수를 호출할 수 있습니다. 프롬프트 흐름에 Lambda 노드를 포함하면 Amazon Bedrock은 사용자가 지정하는 Lambda 함수에 입력 이벤트를 보냅니다.

구성에서 Lambda 함수의 Amazon 리소스 이름 (ARN) 을 지정합니다. Lambda 입력 이벤트에서 전송할 입력을 정의합니다. 이러한 입력을 기반으로 코드를 작성하고 함수가 반환하는 내용을 정의할 수 있습니다. 함수 응답이 출력에 반환됩니다.

다음은 함수 FlowNode객체의 일반 구조를 보여줍니다.

{
    "name": "string",
    "type": "LambdaFunction",
    "inputs": [
       {
            "name": "string",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        ...
    ],
    "outputs": [
        {
            "name": "functionResponse",
            "type": "String | Number | Boolean | Object | Array"
        }
    ],
    "configuration": {
        "lambdaFunction": {
            "lambdaArn": "string"
        }
    }
}

프롬프트 플로우를 위한 Lambda 입력 이벤트

Lambda 노드의 Lambda 함수로 전송되는 입력 이벤트는 다음과 같은 형식입니다.

{
   "messageVersion": "1.0",
   "flow": {
        "flowArn": "string",
        "flowAliasArn": "string"
   },
   "node": {
        "name": "string",
        "nodeInputs": [
            {
               "name": "string",
               "type": "String | Number | Boolean | Object | Array",
               "expression": "string",
               "value": ...
            },
            ...
        ]
   }
}

각 입력의 필드는 Lambda 노드를 정의할 때 지정한 필드와 일치하며, 표현식으로 확인되면 필드 값이 노드의 value 전체 입력으로 채워집니다. 예를 들어, 노드에 대한 전체 입력이 [1, 2, 3] 이고 $.data[1] 표현식이 인 경우 입력 이벤트에서 Lambda 함수로 전송되는 값은 다음과 같습니다. 2

Lambda의 이벤트에 대한 자세한 내용은 Lambda 개념을 참조하십시오. AWS Lambda 개발자 안내서.

신속한 흐름을 위한 Lambda 응답

Lambda 함수를 작성할 때는 함수에서 반환되는 응답을 정의합니다. 이 응답은 Lambda 노드의 출력으로 프롬프트 흐름에 반환됩니다.

Lex 노드를 사용하면 Amazon Lex 봇을 호출하여 자연어 처리를 사용하여 발화를 처리하고 봇 정의를 기반으로 의도를 식별할 수 있습니다. 자세한 내용은 Amazon Lex 개발자 안내서를 참조하십시오.

구성에서 사용할 봇의 별칭과 사용할 로케일의 Amazon 리소스 이름 (ARN) 을 지정합니다. 노드에 입력되는 내용은 발화 및 그에 수반되는 요청 속성 또는 세션 속성입니다. 노드는 식별된 의도를 출력으로 반환합니다.

다음은 Lex FlowNode객체의 일반적인 구조를 보여줍니다.

{
    "name": "string",
    "type": "Lex",
    "inputs": [
       {
            "name": "inputText",
            "type": "String | Number | Boolean | Object | Array",
            "expression": "string"
        },
        {
            "name": "requestAttributes",
            "type": "Object",
            "expression": "string"
        },
        {
            "name": "sessionAttributes",
            "type": "Object",
            "expression": "string"
        }
    ],
    "outputs": [
        {
            "name": "predictedIntent",
            "type": "String"
        }
    ],
    "configuration": {
        "lex": {
            "botAliasArn": "string",
            "localeId": "string"
        }
    }
}