# Criar agentes de IA com o Amazon Nova
<a name="agents"></a>

**nota**  
Esta documentação é para o Amazon Nova versão 1. Para obter informações sobre como criar agentes de IA com o Amazon Nova 2, acesse [Criação de agentes de IA](https://docs.aws.amazon.com/nova/latest/nova2-userguide/building-ai-agents.html).

O agente de IA ajuda os usuários finais a concluir ações com base nos dados da organização e na entrada do usuário. Os agentes orquestram as interações entre modelos de base (FMs), fontes de dados, aplicações de software e conversas com usuários. Além disso, os agentes chamam automaticamente as APIs para executar ações e invocar bases de conhecimento para complementar as informações dessas ações. Os desenvolvedores podem economizar semanas de esforço de desenvolvimento integrando agentes para acelerar a entrega de aplicações de inteligência artificial generativa (IA generativa).

Com os agentes, é possível automatizar tarefas para os clientes e responder perguntas. Por exemplo, é possível criar um agente que ajude os clientes a processar reivindicações de seguro ou um que ajude os clientes a fazer reservas de viagens. Você não precisa provisionar capacidade, gerenciar a infraestrutura ou escrever código personalizado. O Amazon Nova gerencia a engenharia de prompts, a memória, o monitoramento, a criptografia, as permissões de usuários e a invocação de APIs.

Para obter informações sobre a criação de agentes de IA no Amazon Bedrock, consulte os [Agentes para Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html).

Os agentes executam as seguintes tarefas:
+ Estendem os modelos de base para compreender as solicitações dos usuários e dividir as tarefas que o agente precisa executar em etapas menores.
+ Coletam informações adicionais de um usuário por meio de uma conversa em linguagem natural.
+ Executam ações para atender à solicitação de um cliente fazendo chamadas de API para os sistemas da empresa.
+ Aumentam a performance e a precisão por meio de consultas às fontes de dados.

**Topics**
+ [

# Usar o Amazon Nova como um modelo de base em um agente de IA
](agents-use-nova.md)
+ [

## Como usar o Amazon Nova com AgentCore
](#agents-agentcore)
+ [

## Como usar o Amazon Nova com Strands
](#agents-strands)
+ [

## Recursos adicionais
](#agents-resources)

# Usar o Amazon Nova como um modelo de base em um agente de IA
<a name="agents-use-nova"></a>

Para usar os modelos do Amazon Nova como modelo de base em um agente de IA, você pode usar os [Agentes para Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-how.html) ou pode [chamar uma ferramenta com a API Converse](https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use-inference-call.html) ou API InvokeModel. Os Agentes para Amazon Bedrock é um serviço totalmente gerenciado que você pode usar para criar e configurar agentes autônomos em sua aplicação. Você também pode usar a API Converse e a API InvokeModel para se conectar a outros frameworks de agentes prontos para uso ou criar seu própria framework de agentes.

É possível usar as variáveis de espaço reservado nos modelos de prompt de agente. As variáveis serão preenchidas com base em configurações preexistentes quando o modelo de prompt for chamado. Para obter informações sobre essas variáveis de espaço reservado, consulte [Use placeholder variables in Amazon Bedrock agent prompt templates](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-placeholders.html).

**Topics**
+ [

## Usar o Amazon Nova com Agentes para Amazon Bedrock
](#agents-bedrock)
+ [

## Usar o Amazon Nova com as APIs Invoke e Converse
](#agents-converse)

## Usar o Amazon Nova com Agentes para Amazon Bedrock
<a name="agents-bedrock"></a>

Os modelos do Amazon Nova estão habilitados nos [agentes para Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html) e seguem as instruções de usuário dos Agentes para Amazon Bedrock. Os Agentes para Amazon Bedrock são pré-configurados com os recursos e prompts essenciais para trabalhar de forma eficaz com os modelos do Amazon Nova. Essas configurações permitem que você aproveite os principais recursos dos Agentes para Amazon Bedrock com o mínimo esforço:
+ **Agentes autônomos**: os Agentes para Amazon Bedrock permitem a criação de agentes autônomos que podem realizar tarefas com base na entrada do usuário e nos dados organizacionais sem exigir codificação personalizada extensa. Isso pode economizar tempo e esforço significativos.
+ **Invocação de API integrada**: os Agentes para Amazon Bedrock lidam automaticamente com as chamadas de API para atender às solicitações dos usuários, o que simplifica a integração de serviços externos e fontes de dados.
+ **Gerenciamento de memória e contexto**: os agentes podem manter o contexto, a conversa e a memória em todas as interações, permitindo conversas mais personalizadas e coerentes ao longo do tempo.
+ **Integração da base de conhecimento**: você pode associar uma base de conhecimento ao agente para aprimorar seu desempenho e precisão, permitindo que ele forneça respostas mais relevantes com base nas informações armazenadas.
+ **Personalização e engenharia de prompts**: os Agentes para Amazon Bedrock são compatíveis com engenharia de prompts avançada, permitindo que os desenvolvedores personalizem o comportamento e as respostas do agente para melhor se adequar a casos de uso específicos.
+ **Intérprete 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.
+ **Colaboração multiagente:** crie, implante e gerencie vários agentes de IA trabalhando juntos em tarefas complexas de várias etapas que exigem habilidades especializadas.

## Usar o Amazon Nova com as APIs Invoke e Converse
<a name="agents-converse"></a>

Também é possível aproveitar [Uso de ferramentas (chamada de função) com o Amazon Nova](tool-use.md) com as APIs Invoke e Converse para integrar modelos do Amazon Nova com frameworks de código aberto ou criar frameworks personalizados de agentes de IA. Isso permite uma grande flexibilidade, mas é importante observar que usar a API diretamente significa que alguns aspectos são deixados para sua implementação ou biblioteca lidar:

1. **Armazenar dados de conversação e usuários**: a API Converse não retém nenhuma entrada do usuário ou conteúdo gerado, o que significa que seu agente não consegue se lembrar de interações passadas. Você precisará passar todas as mensagens anteriores toda vez que invocar o modelo.

1. **Invocação automática de ferramenta**: você, como desenvolvedor, é responsável por implementar a ferramenta com base na solicitação do modelo. Isso significa que você precisa executar ou escrever o código que executa a funcionalidade da ferramenta e processa os parâmetros de entrada fornecidos pelo modelo. Depois de executar a ferramenta, você deve enviar os resultados de volta ao modelo em um formato estruturado.

1. **Memória incorporada**: a API não tem recursos de memória incorporados, o que significa que seu agente não consegue se lembrar das preferências do usuário ou das interações passadas ao longo do tempo, o que pode limitar a personalização.

## Como usar o Amazon Nova com AgentCore
<a name="agents-agentcore"></a>

Os modelos do Amazon Nova podem ser usados com todos os serviços Bedrock AgentCore, permitindo que você implante e opere agentes altamente eficazes com segurança e em grande escala. Os principais serviços incluem tempo de execução, identidade, memória, gateway e observabilidade. Consulte o Amazon Bedrock AgentCore para obter detalhes adicionais e \$1placeholder\$1 para ver o código de amostra.

Veja a seguir um exemplo de uso do Amazon Nova com o AgentCore:

```
import boto3
from strands.models import BedrockModel

# Create a Bedrock model with the custom session
bedrock_model = BedrockModel(
model_id="model_id",
boto_session=session
)
```

## Como usar o Amazon Nova com Strands
<a name="agents-strands"></a>

 O Strands fornece suporte nativo para o Amazon Bedrock, permitindo que você use esses modelos do Nova em seus agentes com configuração mínima. Consulte Strands Amazon Bedrock para obter mais detalhes. 

Veja a seguir um exemplo de código que mostra como usar o Strands com o Amazon Nova:

```
from strands import Agent
from strands.models import BedrockModel

# Create a Bedrock model instance
bedrock_model = BedrockModel(
    model_id="us.amazon.nova-premier-v1:0",
    temperature=0.3,
    top_p=0.8,
)

# Create an agent using the BedrockModel instance
agent = Agent(model=bedrock_model)

# Use the agent
response = agent("Tell me about Amazon Bedrock.")
```

## Recursos adicionais
<a name="agents-resources"></a>

1. [Automate tasks in your application using agents](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)

1. [Uso de ferramentas (chamada de função) com o Amazon Nova](tool-use.md)

1. [Práticas recomendadas para criação de prompts de compreensão de texto](prompting-text-understanding.md)