Pular para o conteúdo principal

Como criar um agente que faz chamadas a APIs

Neste tutorial, teremos uma noção de como criar um agente que consegue fazer chamadas de API.

Passo 1: Criando o agente​

  1. No menu lateral, acesse Agentes e clique em "+ Criar agente", escolhendo Criação avançada.

  2. Preencha as informações principais do agente.

  3. Na aba Modelo de IA, escolha o modelo do agente.

Neste tutorial, escolha um modelo com janela de contexto ampla, o que é ideal dependendo das respostas de uma determinada API, já que algumas APIs podem retornar centenas, se não milhares de linhas de dados. Para escolher, veja Modelos.

ATENÇÃO

Certifique-se de que sua API retorna um número limitado de dados que obedeça o número de tokens por interação que seu modelo comporta!

Passo 2: Criando a competência​

  1. No menu lateral, acesse Competências & MCPs e clique em "+ Criar competência".

  2. Preencha os campos necessários.

  3. Volte ao menu lateral, acesse Competências & MCPs para ver a lista de competências criadas.

  4. Encontre a competência criada e clique no ícone de lâmpada (Habilidades).

  5. Clique em "+ Criar Habilidade" ou "Criar nova Habilidade".

  6. Preencha o Nome da habilidade, a Descrição (que orienta o agente sobre quando usar a habilidade), o Método HTTP e a URL Base da API de previsão do tempo, e use as abas Headers, Params e Query Params para os parâmetros da requisição. Veja o detalhe de cada campo em Listar Competências.

Passo 3: Adicionando a competência ao agente​

Esse passo, apesar de muitas vezes esquecido, é crucial para o processo. Após criar a competência e as habilidades, sempre certifique-se de que elas estão atreladas ao agente.

  1. No menu lateral, acesse Agentes, encontre o agente criado e clique em "Editar".

  2. Na aba Competências & MCPs, no campo Competências & MCPs, selecione a competência criada. Em seguida, clique em "Salvar".

Agora, na próxima vez que formos conversar com o agente, podemos perguntar sobre as condições do tempo em uma determinada cidade, e ele responderá.

Podemos verificar que a chamada foi feita com efetividade, fazendo a chamada nós mesmos através de um navegador de internet e comparando-se os resultados encontrados nos dois casos.

Observe que as informações retornadas são exatamente as mesmas que o agente nos apresentou, o que significa que foram tiradas dessa API corretamente.