Amazon Bedrock에서 에이전트에 작업 그룹 추가

에이전트에 작업 그룹을 추가하려면

1. Amazon Bedrock 권한이 있는 역할을 AWS Management Console 사용하여 에 로그인하고 에서 Amazon Bedrock 콘솔을 엽니다https://console.aws.amazon.com/bedrock/. IAM

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

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

4. 작업 그룹 섹션에서 추가를 선택합니다.

5. (선택 사항) 작업 그룹 세부 정보 섹션에서 자동으로 생성된 이름을 변경하고 작업 그룹에 대한 선택적 설명을 제공합니다.

6. 작업 그룹 유형 섹션에서 다음 방법 중 하나를 선택하여 에이전트가 작업을 수행하는 데 도움이 되도록 사용자로부터 유도할 수 있는 파라미터를 정의합니다.

   1. 함수 세부 정보로 정의 - 작업을 수행하기 위해 에이전트가 사용자로부터 유도할 파라미터를 정의합니다. 함수 추가에 대한 자세한 내용은 섹션을 참조하세요Amazon Bedrock에서 에이전트의 작업 그룹에 대한 함수 세부 정보를 정의하십시오..

   2. 스키마로 정의 API - 에이전트가 호출할 수 있는 API 작업과 파라미터 를 정의합니다. 생성한 스키API마 열기를 사용하거나 콘솔 텍스트 편집기를 사용하여 스키마를 생성합니다. OpenAPI 스키마 설정에 대한 자세한 내용은 섹션을 참조하세요. 정의 OpenAPI Amazon Bedrock에서 에이전트의 작업 그룹에 대한 스키마

7. 작업 그룹 호출 섹션에서 호출해야 하는 API 또는 함수를 예측하고 필요한 파라미터를 수신한 후 에이전트가 수행하는 작업을 설정합니다. 다음 옵션 중 하나를 선택합니다.

   • 빠른 새 Lambda 함수 생성 - 권장 - Amazon Bedrock이 에이전트에 대한 기본 Lambda 함수를 생성하도록 하면 나중에 사용 사례에 AWS Lambda 맞게 수정할 수 있습니다. 에이전트는 예측한 API 또는 함수와 세션을 기반으로 한 파라미터를 Lambda 함수에 전달합니다.

   • 기존 Lambda 함수 선택 - 이전에 에서 생성한 Lambda 함수 AWS Lambda 와 사용할 함수 버전을 선택합니다. 에이전트는 예측한 API 또는 함수와 세션을 기반으로 한 파라미터를 Lambda 함수에 전달합니다.

     참고

     Amazon Bedrock 서비스 보안 주체가 Lambda 함수에 액세스할 수 있도록 하려면 리소스 기반 정책을 Lambda 함수에 연결하여 Amazon Bedrock 서비스 보안 주체가 Lambda 함수에 액세스할 수 있도록 합니다.

   • 반환 제어 - 에이전트는 Lambda 함수에 예측하는 API 또는 함수에 대한 파라미터를 전달하는 대신 세션에서 결정한 작업에 대한 파라미터 및 정보 외에도 예측해야 하는 작업을 전달하여 애플리케이션에 제어를 반환합니다. InvokeAgent 응답. 자세한 내용은 추출된 정보를 응답으로 전송하여 에이전트 개발자에게 제어권을 반환합니다. InvokeAgent 단원을 참조하십시오.

8. 작업 그룹 유형 에 대한 선택에 따라 다음 섹션 중 하나가 표시됩니다.

   • 함수 세부 정보로 정의를 선택한 경우 작업 그룹 함수 섹션이 표시됩니다. 함수를 정의하려면 다음을 수행합니다.

     1. 이름 및 선택적(권장) 설명을 입력합니다.

     2. 함수를 호출하기 전에 사용자에게 확인을 요청하려면 활성화 를 선택합니다. 함수를 호출하기 전에 확인을 요청하면 악성 프롬프트 주입으로 인해 애플리케이션이 조치를 취하지 않도록 보호할 수 있습니다.

     3. 파라미터 하위 섹션에서 파라미터 추가를 선택합니다. 다음 필드를 정의합니다.

        필드	설명
        명칭	파라미터에 이름을 지정합니다.
        설명(선택 사항)	파라미터를 설명합니다.
        유형	파라미터의 데이터 유형을 지정합니다.
        필수	에이전트에 사용자의 파라미터가 필요한지 여부를 지정합니다.

     4. 다른 파라미터를 추가하려면 파라미터 추가를 선택합니다.

     5. 파라미터에서 필드를 편집하려면 필드를 선택하고 필요에 따라 편집합니다.

     6. 파라미터를 삭제하려면 파라미터가 포함된 행에서 삭제 아이콘( )을 선택합니다.

     JSON 객체를 사용하여 함수를 정의하려면 표 대신 JSON 편집기를 선택합니다. JSON 객체 형식은 다음과 같습니다(parameters객체의 각 키는 사용자가 제공하는 파라미터 이름임).

     {
         "name": "string",
         "description": "string",
         "parameters": [
             {
                 "name": "string",
                 "description": "string",
                 "required": "True" | "False",
                 "type": "string" | "number" | "integer" | "boolean" | "array"
             }
         ]
     }

     다른 파라미터 세트를 정의하여 작업 그룹에 다른 함수를 추가하려면 작업 그룹 함수 추가를 선택합니다.

   • 스키마API로 정의를 선택한 경우 다음 옵션이 포함된 작업 그룹 스키마 섹션이 표시됩니다.

     • 작업 그룹에 대한 API 설명, 구조 및 파라미터로 이전에 준비한 OpenAPI 스키마를 사용하려면 API 스키마 선택을 선택하고 스키마URI의 Amazon S3에 대한 링크를 제공합니다.

     • 인라인 스키마 편집기로 스키API마 열기를 정의하려면 인라인 스키마 편집기를 통해 정의를 선택합니다. 편집할 수 있는 샘플 스키마가 나타납니다.

       1. 형식 옆의 드롭다운 메뉴를 사용하여 스키마의 형식을 선택합니다.

       2. 편집할 S3에서 기존 스키마를 가져오려면 스키마 가져오기 를 선택하고 S3 를 입력한 URI다음 가져오기 를 선택합니다.

       3. 스키마를 원래 샘플 스키마로 복원하려면 재설정을 선택한 다음 재설정을 다시 선택하여 나타나는 메시지를 확인합니다.

9. 작업 그룹 생성을 완료했으면 추가를 선택합니다. API 스키마를 정의한 경우 문제가 없으면 녹색 성공 배너가 나타납니다. 스키마를 검증하는 데 문제가 있는 경우 빨간색 배너가 나타납니다. 다음과 같은 옵션이 있습니다:

   • 스키마를 스크롤하여 형식 지정에 대한 오류 또는 경고가 있는 줄을 확인합니다. X는 서식 오류를 나타내고 느낌표는 서식 관련 경고를 나타냅니다.

   • 빨간색 배너에서 세부 정보 보기를 선택하여 API 스키마의 콘텐츠에 대한 오류 목록을 확인합니다.

10. 에이전트를 테스트하기 전에 에이전트에 변경한 내용을 적용할 준비를 해야 합니다.