Pré-requisitos

nota

Os recursos de configuração e invocação de um recurso de agente em linha está em uma versão prévia do Amazon Bedrock e está sujeito a alterações.

Atenda aos seguintes pré-requisitos antes de invocar seu agente em linha:

1. Determine qual modelo de base você quer usar para configurar seu agente integrado, a região em que deseja invocar o agente e uma instrução que mostre ao agente integrado o que ele deve fazer.

2. Crie ou prepare uma ou mais das propriedades de agente do Amazon Bedrock a seguir que você quer usar para o agente em linha.

   Campo	Caso de uso
   actionGroups	Forneça uma lista de grupos de ação em que cada grupo de ação define as ações que o agente integrado pode realizar. Por exemplo, você pode definir um compromisso de grupo de ação que ajude os usuários a realizar ações como CreateAppointment, GetAppointment, CancelAppointment, etc.
   guardrailConfiguration	Configure barreiras de proteção para bloquear tópicos, evitar alucinações e implementar proteções para sua aplicação.
   knowledgeBases	Associações de knowledgeBases com o agente em linha para aumentar a resposta gerada pelo modelo. As bases de conhecimento podem ser usadas não apenas para responder às consultas dos usuários e analisar documentos, mas também para ampliar os prompts fornecidos aos modelos de base por meio de contexto adicional.
   promptOverridenConfiguration	Configure prompts de substituição em diferentes partes da sequência de um agente para aprimorar a precisão do agente em linha.
   customerEncryptionArn	Especifique o Amazon Resource Name (ARN) da AWS KMS chave a ser usada para criptografar seu agente embutido.

3. Crie uma função de AWS Identity and Access Management (IAM) e anexe a política mencionada nesta etapa à função.

   Antes de invocar um agente integrado, você deve criar um perfil do IAM que forneça as permissões necessárias para usar a API InvokeInlineAgent e acessar determinados recursos, como funções do Lambda, bases de conhecimento e modelos de base.

   Crie um perfil de serviço personalizado para o agente em linha seguindo as etapas em Criar um perfil para conceder permissões a um usuário do IAM. Depois de criar o perfil do IAM, anexe a política a seguir ao perfil.

   nota

   Como prática recomendada para fins de segurança, substitua o ${region}${account-id}, e *.ids por Região, o ID da sua conta e os IDs de recursos específicos depois de criá-los.