Adicionar um grupo de ação ao agente no Amazon Bedrock

Como adicionar um grupo de ação ao agente

1. Faça login no AWS Management Console usando uma IAMfunção com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em. https://console.aws.amazon.com/bedrock/

2. No painel de navegação à esquerda, selecione Agentes. Escolha um agente na seção Agentes.

3. Escolha Editar no Construtor de agentes.

4. Selecione Adicionar na seção Grupos de ação.

5. (Opcional) Na seção Detalhes do grupo de ação, altere o Nome gerado automaticamente e forneça uma Descrição opcional para grupo de ação.

6. Na seção Tipo do grupo de ação, selecione um dos seguintes métodos para definir os parâmetros que o agente pode obter dos usuários para ajudar a executar ações:

   1. Definir com detalhes da função: defina parâmetros para o agente obter do usuário a fim de executar as ações. Para obter mais informações sobre como adicionar funções, consulte Definir detalhes da função para os grupos de ação do agente no Amazon Bedrock.

   2. Definir com API esquemas — Defina as API operações que o agente pode invocar e os parâmetros. Use um API esquema Open que você criou ou use o editor de texto do console para criar o esquema. Para obter mais informações sobre como configurar um API esquema aberto, consulte Definir OpenAPI esquemas para os grupos de ação do seu agente no Amazon Bedrock

7. Na seção Invocação do grupo de ações, você configura o que o agente faz depois de prever a função API or que ele deve invocar e receber os parâmetros necessários. Escolha uma das seguintes opções:

   • Crie rapidamente uma nova função Lambda — recomendada — Deixe o Amazon Bedrock criar uma função Lambda básica para seu agente, que você poderá modificar posteriormente para seu caso AWS Lambda de uso. O agente passará a função API or que ele prevê e os parâmetros, com base na sessão, para a função Lambda.

   • Selecione uma função Lambda existente — Escolha uma função Lambda que você criou anteriormente AWS Lambda e a versão da função a ser usada. O agente passará a função API or que ele prevê e os parâmetros, com base na sessão, para a função Lambda.

     nota

     Anexe uma política baseada em recurso à função do Lambda para permitir que a entidade principal do serviço Amazon Bedrock acesse a função do Lambda.

   • Controle de retorno — Em vez de passar os parâmetros da função API or que ele prevê para a função Lambda, o agente retorna o controle ao seu aplicativo passando a ação que ele prevê que deve ser invocada, além dos parâmetros e informações da ação que ele determinou na sessão, no InvokeAgentresposta. Para obter mais informações, consulte Retornar o controle ao desenvolvedor do agente enviando informações obtidas em uma resposta do InvokeAgent.

8. Dependendo da sua escolha para o Tipo do grupo de ação, você verá uma das seguintes seções:

   • Se você selecionou Definir com detalhes da função, você terá uma seção de Função do grupo de ação. Para definir a função:

     1. Forneça um Nome e uma Descrição opcional (mas recomendada).

     2. Para solicitar a confirmação do usuário antes que a função seja invocada, selecione Habilitado. Solicitar confirmação antes de invocar a função pode impedir que a aplicação execute ações devido a injeções de prompt maliciosas.

     3. Na subseção Parâmetros, escolha Adicionar parâmetro. Defina os seguintes campos:

        Campo	Descrição
        Name	Dê um nome ao parâmetro.
        Descrição (opcional)	Descreve o parâmetro.
        Tipo	Especifique o tipo dados do parâmetro.
        Obrigatório	Especifique se o agente precisa do parâmetro do usuário.

     4. Para adicionar outro parâmetro, escolha Adicionar parâmetro.

     5. Para editar um campo em um parâmetro, selecione o campo e edite-o conforme necessário.

     6. Para excluir um parâmetro, escolha o ícone de exclusão ( ) na linha que contém o parâmetro.

     Se você preferir definir a função usando um JSON objeto, escolha JSONeditor em vez de Tabela. O formato do JSON objeto é o seguinte (cada chave no parameters objeto é um nome de parâmetro que você fornece):

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

     Para adicionar outra função ao grupo de ação definindo outro conjunto de parâmetros, escolha Adicionar função de grupo de ação.

   • Se você selecionou Definir com API esquemas, você terá uma seção Esquema do grupo de ações com as seguintes opções:

     • Para usar um API esquema aberto que você preparou anteriormente com API descrições, estruturas e parâmetros para o grupo de ação, selecione Selecionar API esquema e forneça um link para o Amazon URI S3 do esquema.

     • Para definir o API esquema aberto com o editor de esquema em linha, selecione Definir por meio do editor de esquema em linha. É exibido um exemplo de esquema que você pode editar.

       1. Selecione o formato do esquema usando o menu suspenso ao lado de Formato.

       2. Para importar um esquema existente do S3 para edição, selecione Importar esquema, forneça o S3 URI e selecione Importar.

       3. Para restaurar o esquema de volta ao exemplo original, selecione Redefinir e confirme a mensagem exibida selecionando Redefinir novamente.

9. Ao concluir a criação do grupo de ação, escolha Adicionar. Se você definiu um API esquema, um banner verde de sucesso será exibido se não houver problemas. Se houver problemas na validação do esquema, um banner vermelho será exibido. Você tem as seguintes opções:

   • Percorra o esquema para ver as linhas em que há um erro ou aviso sobre formatação. Um X indica um erro de formatação, e um ponto de exclamação indica um aviso sobre formatação.

   • Selecione Exibir detalhes no banner vermelho para ver uma lista de erros sobre o conteúdo do API esquema.

10. Use Preparar para aplicar as alterações feitas no agente antes de testá-lo.