> For the complete documentation index, see [llms.txt](https://zaiadocs.gitbook.io/recursos/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zaiadocs.gitbook.io/recursos/agentes/como-criar-um-agente/actions/action-chamar-uma-api-nao-finalizado.md).
# Action: Chamar uma API - Não finalizado
Este guia é essencial para quem deseja integrar ações e APIs nas instruções específicas de um agente. Ele permite personalizar e otimizar as interações do agente, além de orientar sobre como configurar chamadas de API para coletar dados de forma eficiente. A possibilidade de usar variáveis e formatar respostas da API oferece flexibilidade e controle sobre as operações do agente.
**Passo a Passo:**
1. Escolha o agente de IA que você deseja configurar.
2. Clique na engrenagem para abrir as configurações do agente.
3. Clique na opção "Personalidade".
4. No menu, selecione a aba "Instruções".
5. Clique em "Adicionar estágio específico".
6. Digite um nome para o estágio.
7. Defina a condição para acionamento do estágio. Para adicionar uma variável, digite
`@data.[nome_da_variável]`.
8. Adicione as instruções que o agente deve seguir após a chamada de API.
9. Clique em "2.Ação que o Agente deve efetuar" e selecione a ação de chamada de API.
10. Uma nova tela será aberta para conectar a API. Adicione a URL ou Webhook da API.
11. Escolha o método que será utilizado pela API.
12. Adicione o Body da requisição.
13. Formate como a resposta da API deve ser exibida. Você pode usar variáveis no formato
`@response.[nome_do_atributo]`.
14. Selecione a opção "Extrair as informações da resposta da API" para preencher as variáveis e fornecer dados para a resposta do agente.
15. Clique em "Salvar API".
16. Observe que a ação "Chamar API" foi adicionada com sucesso.
17. Para salvar e treinar o agente com a nova configuração, clique em "Treinar Agente IA"
{% embed url="" %}