Amazon Bedrock에서 플로우 생성하기

참고

프롬프트 플로우는 미리 보기 중이며 변경될 수 있습니다.

프롬프트 흐름을 생성하려면 최소한 프롬프트 흐름의 이름과 설명을 제공하고 적절한 권한이 있는 서비스 역할을 지정하십시오 (또는 Amazon Bedrock 콘솔이 자동으로 생성하도록 하십시오). 그런 다음 프롬프트 흐름에서 단계 역할을 하는 노드와 노드 간 연결을 구성하여 프롬프트 흐름을 정의합니다. 흐름을 생성하기 전에 Amazon Bedrock용 Prompt flows의 개념과 용어를 숙지하고 사용 가능한 노드 유형에 대해 알아보는 것이 좋습니다. Amazon Bedrock의 프롬프트 플로우 작동 방식 프롬프트 플로우를 생성하는 방법을 알아보려면 선택한 방법에 해당하는 탭을 선택하고 단계를 따르십시오.

Console

플로우를 생성하려면

1. Amazon Bedrock 권한이 있는 IAM 역할 AWS Management Console 사용에 로그인하고 시작하기에서 Amazon Bedrock 콘솔을 엽니다. AWS Management Console

2. 왼쪽 탐색 창에서 프롬프트 플로우를 선택합니다.

3. 프롬프트 흐름 섹션에서 프롬프트 흐름 만들기를 선택합니다.

4. 흐름 이름과 설명 (선택 사항) 을 입력합니다.

5. 서비스 역할 이름의 경우 다음 옵션 중 하나를 선택합니다.

   • 새 서비스 역할 생성 및 사용 — Amazon Bedrock에서 사용자가 사용할 서비스 역할을 생성하도록 합니다.

   • 기존 서비스 역할 사용 — 이전에 설정한 사용자 지정 서비스 역할을 선택합니다. 자세한 내용은 Amazon Bedrock에서 프롬프트 플로우에 대한 서비스 역할 생성 단원을 참조하십시오.

6. (선택 사항) KMS 키를 사용하여 프롬프트 흐름을 암호화하려면 암호화 설정 사용자 지정 (고급) 을 선택하고 키를 선택합니다. 자세한 내용은 Amazon Bedrock이 플로우를 암호화 및 복호화할 수 있도록 허용하는 주요 정책 단원을 참조하십시오.

7. 생성(Create)을 선택합니다. 흐름이 생성되고 흐름을 작성할 수 있는 프롬프트 플로우 빌더로 이동됩니다.

8. 다음 절차를 계속 수행하여 흐름을 작성하거나 나중에 프롬프트 흐름 빌더로 돌아갈 수 있습니다.

플로우를 작성하려면

1. 아직 프롬프트 플로우 빌더를 사용하지 않았다면 다음과 같이 하세요.

   1. Amazon Bedrock 권한이 있는 IAM 역할 AWS Management Console 사용에 로그인하고 시작하기에서 Amazon Bedrock 콘솔을 엽니다. AWS Management Console

   2. 왼쪽 탐색 창에서 프롬프트 플로우를 선택합니다. 그런 다음 프롬프트 흐름 섹션에서 흐름을 선택합니다.

   3. 프롬프트 플로우 빌더에서 편집을 선택합니다.

2. 프롬프트 플로우 빌더 섹션에서 가운데 창에는 플로우 입력 노드와 플로우 출력 노드가 표시됩니다. 플로우의 입력 및 출력 노드입니다.

3. 노드 추가 및 구성하기

   1. 프롬프트 플로우 빌더 창에서 노드를 선택합니다.

   2. 흐름의 첫 번째 단계에서 사용할 노드를 드래그하여 가운데 창에 놓습니다.

   3. 노드의 원은 연결 지점입니다. 흐름 입력 노드를 두 번째 노드에 연결하려면 흐름 입력 노드의 원에서 방금 추가한 노드의 입력 섹션에 있는 원으로 선을 드래그합니다.

   4. 방금 추가한 노드를 선택합니다.

   5. Prompt Flow Builder 창의 구성 섹션에서 선택한 노드의 구성을 제공하고 노드의 입력 및 출력에 대한 이름, 데이터 유형 및 표현식을 정의합니다.

   6. 프롬프트 플로우 빌더 창에서 노드를 선택합니다.

   7. 단계를 반복하여 흐름의 나머지 노드에 노드를 추가하고 구성합니다.

      참고

      Amazon Bedrock에서 자동으로 생성한 서비스 역할을 사용하는 경우 노드를 추가하면 역할이 적절한 권한으로 업데이트됩니다. 하지만 사용자 지정 서비스 역할을 사용하는 경우 를 참조하여 서비스 역할에 첨부된 정책에 적절한 권한을 추가해야 합니다. Amazon Bedrock에서 프롬프트 플로우에 대한 서비스 역할 생성

4. 흐름의 마지막 노드의 출력을 흐름 출력 노드의 입력과 연결합니다. 플로우 출력 노드를 여러 개 가질 수 있습니다. 흐름 출력 노드를 더 추가하려면 흐름 출력 노드를 드래그하여 흐름을 중지하려는 노드 옆에 놓습니다. 반드시 두 노드를 연결해야 합니다.

5. 다음 절차를 계속하거나 나중에 다시 진행할 수 있습니다. Amazon Bedrock에서 프롬프트 플로우 테스트 다음 단계를 계속하려면 [Save] 를 선택합니다. 나중에 다시 돌아가려면 [저장 후 종료] 를 선택합니다.

노드 또는 연결 삭제

흐름을 구축하는 과정에서 노드를 삭제하거나 노드 연결을 제거해야 할 수 있습니다.

노드를 삭제하려면

1. 삭제하려는 노드를 선택합니다.

2. 프롬프트 플로우 빌더 창에서 삭제 아이콘 ( ) 을 선택합니다.

   참고

   Amazon Bedrock에서 자동으로 생성한 서비스 역할을 사용하는 경우 노드를 추가하면 역할이 적절한 권한으로 업데이트됩니다. 하지만 노드를 삭제해도 관련 권한은 삭제되지 않습니다. 역할 수정 단계에 따라 더 이상 필요하지 않은 권한을 삭제하는 것이 좋습니다.

연결을 제거하려면

• 플로우 빌더 페이지에서 제거하려는 연결을 마우스로 가리킨 다음 확장 아이콘이 표시될 때까지 연결을 노드 밖으로 드래그합니다.

API

흐름을 생성하려면 Amazon Bedrock용 에이전트 빌드 타임 엔드포인트를 사용하여 요청을 보내십시오 (요청 및 응답 형식과 필드 세부 정보는 링크 참조). CreateFlow

필수 필드는 다음과 같습니다.

필드	기본 설명
name	플로우의 이름.
executionRoleArn	흐름을 만들고 관리할 권한이 있는 서비스 ARN 역할의 이름입니다.

다음 필드는 선택 사항입니다.

필드	사용 사례
정의	흐름을 connections 구성하는 nodes 및 를 포함합니다.
설명	흐름을 설명하기 위해서요.
tags	태그를 흐름에 연결하기 위해서입니다. 자세한 내용은 리소스 태깅 단원을 참조하십시오.
customerEncryptionKeyArn	키를 사용하여 흐름을 암호화하는 것. KMS 자세한 내용은 Amazon Bedrock이 플로우를 암호화 및 복호화할 수 있도록 허용하는 주요 정책 단원을 참조하십시오.
clientToken	API요청이 한 번만 완료되도록 하기 위해서입니다. 자세한 내용은 발기 부전 보장을 참조하십시오.

이 definition 필드는 선택 사항이지만 흐름이 제대로 작동하려면 필수 필드입니다. 먼저 정의 없이 흐름을 만들고 그 대신 나중에 흐름을 업데이트하도록 선택할 수 있습니다.

nodes목록에 있는 각 노드에 대해 필드에 노드 유형을 지정하고 type 필드에 해당하는 노드 구성을 제공합니다. config 다양한 유형의 노드 API 구조에 대한 자세한 내용은 을 참조하십시오프롬프트 플로우의 노드 유형.

흐름 구축에는 다음 요구 사항이 적용됩니다.

• 흐름에는 흐름 입력 노드와 흐름 출력 노드가 하나 이상 있어야 합니다.

• 흐름 입력 노드에 대한 입력은 포함할 수 없습니다.

• 흐름 출력 노드에는 출력을 포함할 수 없습니다.

• 노드의 모든 출력은 다운스트림 노드의 입력에 연결되어야 합니다 (에서는 a FlowConnectionwith a를 통해 FlowDataConnectionConfiguration수행됨). API

• 조건 노드의 모든 조건 (기본 조건 포함) 은 다운스트림 노드에 연결되어야 합니다 (에서는 FlowConnectionwith a를 통해 수행됨). API FlowConditionalConnectionConfiguration

흐름 구축에는 다음과 같은 지침이 적용됩니다.

• 먼저 플로우 입력 노드의 출력에 사용할 데이터 유형을 설정합니다. 이 데이터 유형은 흐름을 호출할 때 입력으로 전송할 것으로 예상되는 것과 일치해야 합니다.

• 표현식을 사용하여 흐름의 입력을 정의하는 경우 결과가 입력에 대해 선택한 데이터 유형과 일치하는지 확인하십시오.

• 이터레이터 노드를 포함하는 경우 필요한 노드를 통해 출력을 보낸 후 다운스트림에 컬렉터 노드를 포함시키십시오. 컬렉터 노드는 출력을 배열로 반환합니다.