다중 에이전트 협업 생성 - Amazon Bedrock

다중 에이전트 협업 생성

다중 에이전트 협업을 생성하는 단계는 다음과 같습니다.

  1. 공동 작업자 에이전트를 생성하고 배포합니다. 다중 에이전트 협업 흐름 내에서 특정 태스크를 구현하도록 각 공동 작업자 에이전트를 구성해야 합니다.

  2. 새 감독자 에이전트를 생성하거나 기존 에이전트에 감독자의 역할을 할당합니다. 새 감독자 에이전트를 생성하거나 기존 에이전트를 감독자 에이전트로 식별하는 경우 감독자 에이전트가 여러 공동 작업자 에이전트에서 정보를 처리하는 방법을 지정할 수도 있습니다.

    감독자 에이전트에게 공동 작업자 에이전트의 응답을 조정하는 작업을 할당하거나 감독자 에이전트에게 적절한 공동 작업자 에이전트에게 정보를 라우팅하여 최종 응답을 보내는 태스크를 할당할 수 있습니다. 감독자 에이전트에게 정보를 라우팅하는 태스크를 할당하면 지연 시간이 줄어듭니다.

  3. 공동 작업자 에이전트의 별칭 버전을 감독자 에이전트와 연결합니다.

    참고

    현재 최대 10명의 공동 작업자 에이전트를 감독자 에이전트와 연결할 수 있습니다.

  4. 다중 에이전트 협업 팀을 준비하고 테스트합니다.

  5. 감독자 에이전트를 배포하고 간접 호출합니다.

API, AWS CLI 또는 AWS SDK를 사용하여 Amazon Bedrock 콘솔에서 다중 에이전트 협업을 생성할 수 있습니다. 다중 에이전트 협업을 생성하는 방법을 알아보려면 원하는 방법의 탭을 선택한 다음 단계를 따릅니다.

Console
1단계: 공동 작업자 에이전트 생성
2단계: 새 감독자 에이전트 생성 또는 기존 에이전트에 감독자 역할 할당

  1. 새 감독자 에이전트를 생성하는 경우 에이전트를 수동으로 생성 및 구성에 대한 지침을 따른 후 다음 단계를 계속 진행합니다.

    이미 에이전트가 구성되어 있고 에이전트에 감독자 역할을 할당하려면 다음 단계를 계속합니다.

  2. 아직 에이전트 빌더를 열지 않은 경우 다음 단계를 따릅니다.

    1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명으로 AWS Management 콘솔에 로그인합니다. 그 다음 https://console.aws.amazon.com/bedrock에서 Amazon Bedrock 콘솔을 엽니다.

    2. 왼쪽 탐색 창에서 에이전트를 선택합니다. 에이전트 섹션에서 에이전트를 선택합니다.

    3. 에이전트 빌더에서 편집을 선택합니다.

    4. 에이전트 빌더에서 다중 에이전트 협업 섹션까지 아래로 스크롤하여 편집을 선택합니다.

  3. 다중 에이전트 협업 페이지의 협업 상태 섹션에서 다중 에이전트 협업을 켭니다. 그러면 에이전트가 감독자 에이전트로 식별됩니다.

  4. 협업 구성 섹션에서 감독자 에이전트가 여러 공동 작업자 에이전트의 정보를 처리하여 최종 응답을 조정하는 방법을 선택합니다.

    1. 감독자 에이전트가 공동 작업자 에이전트의 응답을 조정하도록 하려면 감독자를 선택합니다.

    2. 감독자 에이전트가 정보를 적절한 공동 작업자 에이전트에게 라우팅하여 최종 응답을 보내도록 하려면 라우팅 기능이 있는 수퍼바이저를 선택합니다.

    3. 다음 단계를 계속 진행하여 공동 작업자 에이전트를 추가합니다.

3단계: 공동 작업자 에이전트 추가

  1. 에이전트 공동 작업자 섹션을 확장하고 다중 에이전트 협업을 위해 생성한 공동 작업자 에이전트의 세부 정보를 제공합니다.

    1. 공동 작업자 에이전트의 경우 드롭다운에서 공동 작업자 에이전트와 에이전트 별칭을 선택합니다. 보기를 선택하여 공동 작업자 에이전트의 세부 정보를 볼 수 있습니다.

    2. 공동 작업자 이름에 공동 작업자 에이전트의 대체 이름을 입력합니다. 이 이름은 이 에이전트의 원래 이름을 대체하지 않습니다.

    3. 공동 작업 지침에서 감독자 에이전트가 이 공동 작업자를 사용해야 하는 시기에 대한 세부 정보를 입력합니다.

    4. (선택 사항) 감독자 에이전트가 이 공동 작업자 에이전트와 이전 대화의 컨텍스트를 공유하도록 하려면 대화 기록 활성화를 켭니다. 이 기능이 켜져 있는 경우 감독자는 사용자 입력 텍스트와 대화 각 턴의 감독자 에이전트 응답을 포함하여 현재 세션의 전체 기록을 포함합니다.

  2. 공동 작업자 추가를 선택하여 multi-agent-collaboration 팀에 이 공동 작업자 에이전트를 추가합니다. 공동 작업자 에이전트를 더 추가하려면 모든 공동 작업자 에이전트를 추가할 때까지 1단계를 반복합니다.

  3. 공동 작업자 에이전트 추가를 완료했으면 다음 옵션 중 하나를 선택합니다.

    • 다중 에이전트 협업을 유지하려면 저장을 선택하고 다음 단계를 계속 진행하여 다중 에이전트 협업 팀을 준비하고 테스트합니다.

    • 에이전트 세부 정보 페이지로 돌아가려면 저장 및 종료를 선택합니다.

4단계: 다중 에이전트 협업 준비 및 테스트
5단계: 다중 에이전트 협업 배포

  • InvokeAgent 요청을 하도록 감독자 에이전트를 설정하여 다중 에이전트 협업을 배포합니다.

API

다음 단계를 완료하여 다중 에이전트 협업 팀을 생성합니다.

1단계: 공동 작업자 에이전트 생성
2단계: 새 감독자 에이전트 생성 또는 기존 에이전트에 감독자 역할 할당

  • 새로운 감독자 에이전트를 만들려면 Amazon Bedrock Agents 빌드 타임 엔드포인트를 사용하여 CreateAgent 요청(요청 및 응답 형식과 필드 세부 정보는 링크 참조)을 보냅니다.

    기존 에이전트에 감독자 역할을 할당하려면 Amazon Bedrock Agents 빌드 타임 엔드포인트를 사용하여 UpdateAgent 요청을 보냅니다. 모든 필드를 덮어쓰게 되므로 업데이트하려는 필드 및 동일하게 유지하려는 필드를 모두 포함합니다.

    적어도 다음 필드는 반드시 포함해야 합니다.

    필드 사용 사례
    agentResourceRoleArn 에이전트에서 API 작업을 직접적으로 호출할 수 있는 권한이 있는 서비스 역할의 ARN을 지정합니다.
    foundationModel 에이전트가 오케스트레이션할 파운데이션 모델(FM)을 지정합니다.
    instruction 에이전트에게 어떤 작업을 수행해야 하는지 알려주는 지침을 제공합니다. 오케스트레이션 프롬프트 템플릿의 $instructions$ 자리 표시자에서 사용됩니다.
    agentCollaboration

    에이전트에 감독자 역할을 할당합니다.

    감독자 에이전트가 공동 작업자 에이전트의 응답을 조정하고 응답을 출력하도록 하려면 SUPERVISOR를 지정합니다.

    감독자 에이전트가 정보를 적절한 공동 작업자 에이전트로 라우팅하여 최종 응답을 보내도록 하려면 SUPERVISOR_ROUTER를 지정합니다.

    기본적으로 이 필드는 DISABLED로 설정되어 있습니다.

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

    필드 사용 사례
    설명 에이전트가 수행하는 작업을 설명합니다.
    idleSessionTTLInSeconds 에이전트가 세션을 종료하고 저장된 정보를 삭제하는 데 걸리는 시간입니다.
    customerEncryptionKeyArn 에이전트 리소스를 암호화하는 KMS 키의 ARN입니다.
    태그 에이전트에 태그를 연결합니다.
    promptOverrideConfiguration 오케스트레이션의 각 단계에서 FM으로 전송되는 프롬프트를 사용자 지정합니다.
    guardrailConfiguration 에이전트에 가드레일을 추가합니다. 가드레일의 ID 또는 ARN과 사용할 버전을 지정합니다.
    clientToken API 요청이 한 번만 완료되도록 합니다. 자세한 내용은 Ensuring idempotency를 참조하세요.

    응답은 새로 생성된 감독자 에이전트에 대한 세부 정보가 포함된 CreateAgent 객체를 반환합니다. 에이전트를 만들지 못한 경우 응답의 CreateAgent 객체는 failureReasons 목록과 문제 해결을 위한 recommendedActions 목록을 반환합니다.

3단계: 공동 작업자 에이전트 추가

  • 공동 작업자 에이전트에 감독자 에이전트를 연결하려면 Amazon Bedrock Agents 빌드 타임 엔드포인트를 사용하여 AssociateAgentCollaborator 요청(요청 및 응답 형식과 필드 세부 정보는 링크 참조)을 보냅니다.

    적어도 다음 필드는 반드시 포함해야 합니다.

    필드 사용 사례
    collaboratorName 공동 작업자 에이전트의 대체 이름을 지정합니다. 이 이름은 공동 작업 지침에만 표시되며 원래 에이전트 이름을 대체하지 않습니다.
    agentDescriptor 에이전트의 별칭 ARN을 지정합니다.
    collaborationInstruction 공동 작업자 에이전트에게 어떤 작업을 수행해야 하는지 알려주는 지침을 제공합니다.
    relayConversationHistory

    감독자 에이전트가 이 공동 작업자 에이전트와 이전 대화의 컨텍스트를 공유하도록 지정하려면 TO_COLLABORATOR로 설정합니다.

    유효한 값: TO_COLLABORATOR | DISABLED.
4단계: 다중 에이전트 협업자 팀 준비 및 테스트
4단계: 다중 에이전트 협업 팀 배포

  • 감독자 에이전트가 InvokeAgent 요청을 하도록 설정하여 다중 에이전트 협업 팀을 배포합니다.