Connect tools & data

Conexões de API

Transforme qualquer API HTTP em uma função que seu agente pode chamar durante a conversa: cole um comando cURL e o assistente cria a definição da ferramenta, os parâmetros e a autenticação.

As conexões de API são funções HTTP personalizadas que seus agentes podem chamar durante uma conversa — consultar um pedido, criar um ticket, buscar o status da conta no seu próprio backend. Defina o endpoint uma vez em Conexões → APIs (/dashboard/api-connections); os agentes que tiverem a conexão vinculada poderão invocá-la sempre que a conversa exigir.

Há duas formas de criar uma: cole algo que o assistente possa analisar ou configure a conexão manualmente.

O caminho rápido: colar e analisar#

1. Clique em Nova conexão de API

   A caixa de diálogo é aberta no assistente. Cole um exemplo de comando cURL, especificação OpenAPI/Swagger, exportação do Postman, interface TypeScript ou esquema Zod na caixa.

2. Clique em Analisar

   O ThunderPhone infere toda a conexão a partir do que você colou — URL, método, cabeçalhos e um esquema de parâmetros derivado dos parâmetros de consulta e do corpo da solicitação encontrados. Os cabeçalhos que você colou (incluindo cabeçalhos de autenticação) são incluídos na configuração do endpoint.

3. Confirme os campos destacados

   A configuração inferida é aberta com os campos estimados destacados para revisão. Ajuste nomes, descrições e tipos de parâmetros para que o agente entenda quando e como chamar a função — a descrição é o que o modelo lê.

4. Validar e salvar

   Ao salvar, é executada primeiro uma solicitação de teste em tempo real para o seu endpoint. Se a solicitação falhar, a conexão não será salva — corrija a URL, os cabeçalhos de autenticação ou o corpo e tente novamente. Em caso de sucesso, a conexão será armazenada com o selo Validada.

Se o assistente não encontrar uma URL de solicitação no que você colou, ele informará isso — inclua um endpoint http(s) completo e tente novamente.

Configuração manual#

Clique em Configurar manualmente → no assistente (ou em Quer que a IA infira isto? Tente o Assistente → para voltar). O criador manual tem dois editores:

• Visual — campos de formulário para o nome de exibição, nome da função, URL da solicitação, método (POST, GET, PUT, PATCH, DELETE), cabeçalhos personalizados e o esquema de parâmetros (Adicionar propriedade para cada argumento que o agente pode fornecer).
• JSON — a mesma definição em JSON bruto, para colar ou ajustar diretamente uma especificação de ferramenta.

Um painel de Testar solicitação (opcional) permite executar a solicitação configurada antes de salvar e mostra o status, a latência e uma prévia da resposta. Validar e salvar sempre executa esse teste e salva apenas em caso de sucesso.

Gerencie suas conexões#

Cada linha de conexão mostra seu status de validação — Validada, Não testada ou Erro — seu nome de função e quais agentes a utilizam. No menu de ações da linha, você pode:

• Editar — reabrir a configuração.
• Clonar — duplicá-la como ponto de partida (a cópia começa como Não testada).
• Histórico de revisões — visualizar versões anteriores e restaurar uma no editor.
• Transferir — copiar ou mover a conexão para outra organização à qual você pertence. Movê-la a remove daqui; os agentes que a utilizavam podem precisar ser reconfigurados.
• Excluir — permanente; os agentes que usam a conexão precisarão ser reconfigurados.

Vincule-a a um agente#

Adicione a conexão a um agente na seção de conexões de API do criador (Criar um agente). A lista mostra quais agentes usam cada conexão, para que você possa ver rapidamente o que uma alteração afeta.

Próximas etapas#