기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 코드 해석을 활성화하여 애플리케이션의 코드 생성, 실행, 테스트 코드 해석을 통해 에이전트는 보안 테스트 환경에서 애플리케이션 코드를 생성 및 실행하고 코드의 문제를 해결할 수 있습니다. 코드 해석을 사용하면 에이전트의 파운데이션 모델을 사용하여 생성형 AI 애플리케이션 구축에 집중하면서 기본 기능을 구현하기 위한 코드를 생성할 수 있습니다. Amazon Bedrock에서 코드 해석을 사용하여 다음 작업을 수행할 수 있습니다. + 특정 작업에 대한 사용자 요청을 이해하고, 사용자가 요청한 작업을 수행할 수 있는 코드를 생성하고, 코드를 실행하고, 코드 실행의 결과를 제공합니다. + 사용자의 일반 쿼리를 이해하고 코드를 생성 및 실행하여 사용자에게 응답을 제공합니다. + 데이터 분석, 시각화 및 평가를 수행하기 위한 코드를 생성합니다. + 사용자가 업로드한 파일에서 정보를 추출하고, 정보를 처리하고, 사용자 쿼리에 응답합니다. + 빠른 프로토타이핑을 위해 사용자와의 대화를 기반으로 코드를 생성합니다. 기본적으로 AWS 계정별 세션당 최대 동시 활성 코드 해석 수는 25개입니다. 즉, 각 AWS 계정는 코드 인터프리터를 사용하여 에이전트와 한 번에 최대 25개의 지속적인 대화를 가질 수 있습니다. 다음은 Amazon Bedrock 내에서 코드를 생성하고 실행하여 코드 해석의 도움을 받을 수 있는 몇 가지 사용 사례입니다. 1. .csv와 같은 데이터 파일에서 금융 거래를 분석하여 수익 또는 손실이 발생했는지 확인합니다. 1. *2020년 3월 14일*과 같은 날짜 형식을 .txt 또는 .csv 같은 파일 형식의 표준 API 형식인 `YYYY-MM-DD` 형식으로 변환합니다. 1. 스프레드시트(XLS)에서 데이터 분석을 수행하여 분기별/연간 회사 수익 또는 인구 증가율과 같은 지표를 계산합니다. Amazon Bedrock에서 코드 해석을 사용하려면 다음 단계를 따릅니다. + 에이전트를 구축할 때 코드 해석을 활성화합니다. 코드 해석 활성화가 완료되면 사용을 시작할 수 있습니다. + 프롬프트를 제공하여 Amazon Bedrock에서 코드 해석 사용을 시작합니다. 예를 들어 “파이의 제곱근을 127자리까지 계산해 줘” 같은 요청이 가능합니다. 코드 해석은 python 코드를 생성하고 실행하여 응답을 제공합니다. + 파일을 첨부할 수도 있습니다. 파일의 정보를 사용하여 질문을 하고 데이터를 요약하거나 분석할 수 있습니다. 컴퓨터 또는 Amazon S3 버킷에 있는 파일을 첨부할 수 있습니다. **지원되는 리전**: Amazon Bedrock Agents에 대한 코드 해석이 지원되는 리전은 다음과 같습니다. **** | 리전 | | --- | | 미국 동부(버지니아 북부) | | 미국 서부(오리건) | | 유럽(프랑크푸르트) | **파일 지원** 코드 해석을 사용하면 파일을 첨부한 후 첨부된 파일을 사용하여 질문을 하고, 첨부된 파일의 내용을 기반으로 데이터를 요약하거나 분석할 수 있습니다. 최대 5개의 파일을 첨부할 수 있습니다. 모든 파일의 크기를 합하여 최대 10MB까지 가능합니다. + **지원되는 입력 파일 유형:** CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT, PDF + **지원되는 출력 파일 유형:** CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT, PDF, PNG # Amazon Bedrock에서 코드 해석 활성화 에이전트를 [생성](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html)하거나 [업데이트](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit)할 때 Amazon Bedrock 콘솔에서 코드 해석을 활성화할 수 있습니다. API 또는 SDK를 사용하는 경우, 작업 그룹을 [생성](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)하거나 [업데이트](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html)할 때 코드 해석을 활성화할 수 있습니다. Amazon Bedrock에서 코드 해석을 활성화하는 방법을 알아보려면 원하는 방법의 탭을 선택한 후 다음 단계를 따릅니다. ------ #### [ Console ] **에이전트에 대한 코드 해석을 활성화하는 방법** 1. 아직 에이전트 빌더를 열지 않은 경우 다음 단계를 따릅니다. 1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명AWS Management Console으로에 로그인합니다. 그 다음 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)에서 Amazon Bedrock 콘솔을 엽니다. 1. 왼쪽 탐색 창에서 **에이전트**를 선택합니다. **에이전트** 섹션에서 에이전트를 선택합니다. 1. **에이전트 빌더에서 편집**을 선택합니다. 1. **추가 설정** 섹션으로 이동하여 섹션을 확장합니다. 1. **코드 인터프리터**에서 **활성화**를 선택합니다. 1. 먼저 **저장**한 다음 변경한 내용을 에이전트에 적용할 수 있도록 **준비**한 후 테스트해야 합니다. ------ #### [ API ] 에이전트에 대한 코드 해석을 활성화하려면 [Agents for Amazon Bedrock 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) 요청(요청 및 응답 형식과 필드 세부 정보는 링크 참조)을 보내고 다음 필드를 지정합니다. **** | Field | 간단한 설명 | | --- | --- | | actionGroupName | 작업 그룹의 이름입니다. | | parentActionGroupSignature | 에이전트가 코드를 생성하고 테스트할 수 있도록 AMAZON.CodeInterpreter를 지정합니다. | | actionGroupState | 에이전트가 코드 해석을 간접적으로 호출할 수 있도록 ENABLED를 지정합니다. | 다음은 [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) 요청으로 코드 해석을 활성화하는 데 필요한 필드의 일반적인 형식을 보여줍니다. ``` CreateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "ENABLED" } ``` ------ # Amazon Bedrock에서 코드 해석 테스트 Amazon Bedrock에서 코드 해석을 테스트하기 전에 방금 변경한 내용을 적용할 수 있도록 에이전트를 준비해야 합니다. 코드 해석을 활성화한 상태에서 에이전트 테스트를 시작할 때, 필요한 경우 파일을 첨부하고, 첨부한 파일을 코드 해석에 어떻게 사용할 것인지 선택할 수 있습니다. 사용 사례에 따라 코드 해석에 첨부 파일의 정보를 사용하여 파일의 내용을 요약하고 대화형 채팅 대화 중에 파일 내용에 대한 쿼리에 응답하도록 요청할 수 있습니다. 또는 코드 해석에 첨부 파일의 내용을 분석하고 지표 및 데이터 시각화 보고서를 제공하도록 요청할 수 있습니다. **파일 첨부** 코드 해석에 파일을 첨부하는 방법을 알아보려면 원하는 방법의 탭을 선택한 후 다음 단계를 따릅니다. ------ #### [ Console ] **코드 해석에 파일을 첨부하는 방법** 1. 아직 에이전트 빌더를 열지 않은 경우 다음 단계를 따릅니다. 1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명 AWS Management Console 으로에 로그인합니다. 그 다음 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)에서 Amazon Bedrock 콘솔을 엽니다. 1. 왼쪽 탐색 창에서 **에이전트**를 선택합니다. **에이전트** 섹션에서 에이전트를 선택합니다. 1. **에이전트 빌더에서 편집**을 선택합니다. 1. **추가 설정**을 확장하고 **코드 인터프리터**가 활성화되어 있는지 확인합니다. 1. 에이전트가 준비되어 있어야 합니다. 1. 테스트 창이 열리지 않으면 **테스트**를 선택합니다. 1. 테스트 창 하단에서 종이 클립 아이콘을 선택하여 파일을 첨부합니다. 1. **파일 첨부** 페이지에서 다음을 따릅니다. 1. ****함수 선택**에서 다음을 지정합니다.** + 에이전트가 쿼리에 응답하고 내용을 요약하는 데 사용할 파일을 첨부하는 경우, **채팅에 파일 첨부(빠른 방법)**를 선택합니다. + 내용을 분석하고 지표를 제공하기 위해 코드 해석에 파일을 첨부하는 경우, **코드 인터프리터에 파일 첨부**를 선택합니다. 1. ****업로드 방법 선택**에서 파일을 업로드할 위치를 선택합니다.** + 컴퓨터에서 업로드하는 경우 **파일 선택**을 클릭하고 첨부할 파일을 선택합니다. + Amazon S3에서 업로드하는 경우 ** S3 찾아보기**를 선택하고 파일을 선택한 다음, **선택**을 클릭하고 **추가**를 선택합니다. 1. **연결**을 선택합니다. ------ #### [ API ] 코드 해석을 테스트하려면 [Agents for Amazon Bedrock 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [InvokeAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_InvokeAgent.html) 요청(요청 및 응답 형식과 필드 세부 정보는 링크 참조)을 전송합니다. **에이전트가 쿼리에 응답하고 내용을 요약하는 데 사용할 파일을 첨부하려면 다음 필드를 지정합니다.** **** | Field | 간단한 설명 | | --- | --- | | 이름 | 첨부 파일의 이름입니다. | | sourceType | 첨부할 파일의 위치입니다. 파일이 Amazon S3 버킷에 있는 경우 s3을 지정합니다. 파일이 컴퓨터에 있는 경우 byte\$1content를 지정합니다. | | S3Location | 파일이 위치한 S3 경로입니다. S3이 sourceType인 경우 필수 필드입니다. | | mediaType | 첨부 파일의 파일 유형입니다. **지원되는 입력 파일 유형:** CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT, PDF | | 데이터 | base64로 인코딩된 문자열입니다. 최대 파일 크기는 10MB입니다.SDK를 사용하는 경우 파일 바이트 콘텐츠만 제공하면 됩니다. AWS SDK는 문자열을 base64로 자동 인코딩합니다. | | useCase | 첨부 파일을 사용하려는 방법입니다. 유효한 값: CHAT \$1 CODE\$1INTERPRETER | 다음 예제에서는 채팅에 파일을 첨부하는 데 필요한 필드를 지정하는 일반적인 형식을 보여줍니다. ``` "sessionState": { "promptSessionAttributes": { "string": "string" }, "sessionAttributes": { "string": "string" }, "files": [ { "name": "banking_data", "source": { "sourceType": "S3", "s3Location": "uri": "s3Uri" } }, "useCase": "CHAT" }, { "name": "housing_stats.csv", "source": { "sourceType": "BYTE_CONTENT", "byteContent": { "mediaType": "text/csv", "data": "file byte content" } }, "useCase": "CHAT" } ] } ``` 다음 예제에서는 코드 해석을 위해 파일을 첨부하는 데 필요한 필드를 지정하는 일반적인 형식을 보여줍니다. ``` "sessionState": { "promptSessionAttributes": { "string": "string" }, "sessionAttributes": { "string": "string" }, "files": [ { "name": "banking_data", "source": { "sourceType": "S3", "s3Location": { "uri": "s3Uri" } }, "useCase": "CODE_INTERPRETER" }, { "name": "housing_stats.csv", "source": { "sourceType": "BYTE_CONTENT", "byteContent": { "mediaType": "text/csv", "data": "file byte content" } }, "useCase": "CODE_INTERPRETER" } ] } ``` ------ # Amazon Bedrock에서 코드 해석 비활성화 Amazon Bedrock에서 언제든지 코드 해석을 비활성화할 수 있습니다. 코드 해석을 비활성화하는 방법을 알아보려면 원하는 방법의 탭을 선택한 후 다음 단계를 따릅니다. ------ #### [ Console ] **코드 해석을 비활성화하는 방법** 1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명 AWS Management Console 으로에 로그인합니다. 그 다음 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)에서 Amazon Bedrock 콘솔을 엽니다. 1. 왼쪽 탐색 창에서 **에이전트**를 선택합니다. **에이전트** 섹션에서 에이전트를 선택합니다. 1. **에이전트 빌더에서 편집**을 선택합니다. 1. **추가 설정** 섹션을 확장하고 **코드 인터프리터**에서 **비활성화**를 선택합니다. 1. 페이지 상단에서 **준비**를 선택합니다. 그런 다음 **저장**을 선택하여 변경 사항을 에이전트에 저장합니다. ------ #### [ API ] 코드 해석을 비활성화하려면 [Agents for Amazon Bedrock 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [UpdateAgentActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html) 요청(요청 및 응답 형식과 필드 세부 정보는 링크 참조)을 보내고 다음 필드를 지정합니다. **** | Field | 간단한 설명 | | --- | --- | | actionGroupName | 작업 그룹의 이름입니다. | | parentActionGroupSignature | 코드 해석기를 비활성화하려면 AMAZON.CodeInterpreter를 지정합니다. | | actionGroupState | 코드 해석기를 비활성화하려면 DISABLED를 지정합니다. | 다음 예제에서는 코드 해석을 비활성화하기 위해 필수 필드를 지정하는 일반적인 형식을 보여줍니다. ``` UpdateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "DISABLED" } ``` ------ 에이전트에 대한 코드 해석을 비활성화한 후 [Agents for Amazon Bedrock 빌드 타임 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)를 사용하여 [PrepareAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_PrepareAgent.html) 요청(요청 및 응답 형식과 필드 세부 정보는 링크 참조)을 전송해야 합니다.