As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Gerar, executar e testar código da aplicação habilitando a interpretação de código A interpretação de código permite que o agente gere, execute e solucione problemas no código da aplicação em um ambiente de teste seguro. Com a interpretação de código, é possível usar o modelo de base do agente para gerar código para implementação de recursos básicos enquanto você se concentra na criação de aplicações de IA generativa. É possível executar as seguintes tarefas com a interpretação de código no Amazon Bedrock: + Compreender os prompts do usuário para tarefas específicas, gerar um código que possa executar as tarefas solicitadas pelo usuário, executar o código e fornecer o resultado da execução do código. + Compreender as consultas genéricas do usuário, gerar e executar código para responder ao usuário. + Gerar código para executar análise, visualização e avaliação dos dados. + Extrair informações dos arquivos carregados pelo usuário, processar as informações e responder às consultas do usuário. + Gerar código com base nas conversas interativas com o usuário para prototipagem rápida. Por padrão, o número máximo de interpretações de código ativas simultaneamente por sessão e Conta da AWS é 25. Isso significa que cada Conta da AWS pode ter até 25 conversas contínuas com os agentes ao mesmo tempo usando o interpretador de código. Veja alguns dos casos de uso em que a interpretação de código pode ajudar ao gerar e executar o código no Amazon Bedrock. 1. Analisar transações financeiras de um arquivo de dados, como um .csv, para determinar se elas resultaram em lucro ou prejuízo. 1. Conversão do formato de data, como *14 de março de 2020*, em formato de API padrão `YYYY-MM-DD` para formatos de arquivo, como .txt ou .csv 1. Executar análise de dados em uma planilha (XLS) para calcular métricas, como receitas trimestrais/anuais da empresa ou taxa de crescimento populacional. Para usar a interpretação de código no Amazon Bedrock, execute as etapas a seguir. + Habilite a interpretação de código ao criar o agente. Assim que habilitar a interpretação de código, você poderá começar a usá-la. + Comece a usar a interpretação de código no Amazon Bedrock fornecendo prompts. Por exemplo, é possível pedir “calcule a raiz quadrada de pi em 127 dígitos”. A interpretação de código gerará e executará o código python para fornecer uma resposta. + Também é possível anexar arquivos. É possível usar as informações nos arquivos para fazer perguntas e resumir ou analisar dados. É possível anexar os arquivos do computador ou do bucket do Amazon S3. **Regiões da com suporte** É possível usar a interpretação de código do Amazon Bedrock nas seguintes regiões: **** | Região | | --- | | Leste dos EUA (N. da Virgínia) | | Oeste dos EUA (Oregon) | | Europa (Frankfurt) | **Compatibilidade com arquivos** Com a interpretação de código, é possível anexar arquivos e usá-los para fazer perguntas e resumir ou analisar os dados com base no conteúdo dos arquivos anexados. É possível anexar no máximo cinco arquivos. O tamanho total de todos os arquivos pode ser de até 10 MB. + **Tipos de arquivo de entrada compatíveis**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT e PDF + **Tipos de arquivo de saída compatíveis**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT e PDF # Habilitar a interpretação de código no Amazon Bedrock É possível habilitar a interpretação de código no console do Amazon Bedrock ao [criar](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html) ou [atualizar](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit) o agente. Se você estiver usando a API ou SDKs, você pode ativar a interpretação do código ao [criar](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) ou [atualizar](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html) o grupo de ações. Para saber como habilitar a interpretação de código no Amazon Bedrock, escolha a guia correspondente ao método de sua preferência e siga as etapas: ------ #### [ Console ] **Como habilitar a interpretação de código para o agente** 1. Se você ainda não estiver no Construtor de agentes, faça o seguinte: 1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**. 1. Escolha **Editar no Construtor de agentes** 1. Acesse e expanda a seção **Configurações adicionais**. 1. Em **Intérprete de código**, selecione **Habilitar**. 1. Primeiro clique em **Salvar** e em **Preparar** para aplicar as alterações feitas no agente antes de testá-lo. ------ #### [ API ] Para habilitar a interpretação do código para seu agente, envie uma [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)solicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um [endpoint de tempo de construção do Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e especifique os seguintes campos: **** | Campo | Descrição breve | | --- | --- | | actionGroupName | Nome do grupo de ação | | parentActionGroupAssinatura | Especifique AMAZON.CodeInterpreter para permitir que o agente gere e teste o código. | | actionGroupState | Especifique ENABLED para permitir que o agente invoque a interpretação de código. | Veja a seguir o formato geral dos campos obrigatórios para habilitar a interpretação do código com uma [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)solicitação. ``` CreateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "ENABLED" } ``` ------ # Testar a interpretação de código no Amazon Bedrock Antes de testar a interpretação de código no Amazon Bedrock, prepare o agente para aplicar as alterações feitas. Com a interpretação de código habilitada, ao começar a testar o agente, é possível opcionalmente anexar arquivos e escolher como deseja que os arquivos anexados sejam usados pela interpretação de código. Dependendo do caso de uso, é possível solicitar à interpretação de código que use as informações nos arquivos anexados para resumir o conteúdo do arquivo e responder às perguntas sobre o conteúdo do arquivo durante uma conversa de chat interativa. Ou é possível solicitar que interpretação de código analise o conteúdo nos arquivos anexados e fornecer métricas e relatórios de visualização de dados. **Anexar arquivos** Para saber como anexar arquivos para interpretação de código, escolha a guia correspondente ao método de sua preferência e siga as etapas: ------ #### [ Console ] **Para anexar arquivos à interpretação de código,** 1. Se você ainda não estiver no Construtor de agentes, faça o seguinte: 1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**. 1. Escolha **Editar no Construtor de agentes** 1. Expanda **Configurações adicionais** e confirme se o **Intérprete de código** está habilitado. 1. Verifique se o agente está preparado. 1. Se a janela de teste não estiver aberta, escolha **Testar**. 1. Na parte inferior da janela de teste, selecione o ícone do clipe de papel para anexar arquivos. 1. Na página **Anexar arquivos**, 1. **Em **Escolher função**, especifique o seguinte:** + Se estiver anexando arquivos para uso do agente ao responder consultas e resumir o conteúdo, escolha **Anexar arquivos ao chat (mais rápido)**. + Se estiver anexando arquivos para interpretação de código para analisar o conteúdo e fornecer métricas, escolha **Anexar arquivos ao intérprete de código**. 1. **Em **Escolher método de carregamento**, escolha de onde você deseja carregar os arquivos:** + Se estiver carregando do computador, selecione **Escolher arquivos** e selecione os arquivos a serem anexados. + Se estiver carregando do Amazon S3, escolha **Procurar no S3**, selecione **Escolher** e **Adicionar**. 1. Escolha **Anexar**. ------ #### [ API ] Para testar a interpretação do código, envie uma [InvokeAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_InvokeAgent.html)solicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de [construção do Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). **Para anexar arquivos a serem usados pelo agente para responder a dúvidas e resumir o conteúdo, especifique os seguintes campos:** **** | Campo | Descrição breve | | --- | --- | | nome | Nome do arquivo anexado. | | sourceType | Localização do arquivo a ser anexado. Especifique s3 se o arquivo estiver localizado no bucket do Amazon S3. Especifique byte\$1content se o arquivo estiver localizado no computador. | | S3Location | O caminho do S3 em que seu arquivo está localizado. Obrigatório se sourceType for S3. | | mediaType | Tipo do arquivo anexado. **Tipos de arquivo de entrada compatíveis**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT e PDF | | dados | String codificada em Base64. O tamanho máximo do arquivo é 10 MB. Se você estiver usando o SDK, basta fornecer conteúdo de bytes de arquivo. AWS O SDK codifica automaticamente as cadeias de caracteres para base64. | | useCase | Como você deseja que os arquivos anexados sejam usados. Valores válidos: CHAT \$1 CODE\$1INTERPRETER | O exemplo a seguir mostra o formato geral para especificar os campos obrigatórios para anexar arquivos ao chat. ``` "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" } ] } ``` O exemplo a seguir mostra o formato geral para especificar os campos obrigatórios para anexar arquivos à interpretação de código. ``` "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" } ] } ``` ------ # Desabilitar a interpretação de código no Amazon Bedrock É possível desabilitar a interpretação de código no Amazon Bedrock a qualquer momento. Para saber como desabilitar a interpretação de código, escolha a guia correspondente ao método de sua preferência e siga as etapas: ------ #### [ Console ] **Para desabilitar a interpretação de código:** 1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**. 1. Escolha **Editar no Construtor de agentes**. 1. Expanda a seção **Configuração adicional** e escolha **Desabilitar** para **Intérprete de código**. 1. Selecione **Preparar** na parte superior da página. E escolha **Salvar** para salvar as alterações no agente. ------ #### [ API ] Para desativar a interpretação do código, envie uma [UpdateAgentActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html)solicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um [endpoint de tempo de construção do Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e especifique os seguintes campos: **** | Campo | Descrição breve | | --- | --- | | actionGroupName | Nome do grupo de ação | | parentActionGroupAssinatura | Especifique AMAZON.CodeInterpreter para desabilitar o intérprete de código. | | actionGroupState | Especifique DISABLED para desabilitar o intérprete de código. | O exemplo a seguir mostra o formato geral para especificar os campos obrigatórios para desabilitar a interpretação de código. ``` UpdateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "DISABLED" } ``` ------ Depois de desativar a interpretação do código para seu agente, certifique-se de enviar uma [PrepareAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_PrepareAgent.html)solicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de [construção do Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).