Skip to main content
POST
Criar ferramenta utilizadas durante a chamada
Este endpoint permite que você crie uma nova ferramenta utilizadas durante a chamada que pode ser usada por seus assistentes de IA para interagir com APIs externas durante as chamadas.

Parâmetros do Corpo

string
required
Nome da ferramenta - deve conter apenas letras minúsculas e sublinhados, e começar com uma letra (ex: get_weather, book_appointment)
string
required
Explicação detalhada de quando e como a IA deve usar esta ferramenta (máx. 255 caracteres)
string
required
URL válida do endpoint da API a ser chamado
string
required
Método HTTP: GET, POST, PUT, PATCH, ou DELETE
integer
Timeout da solicitação em segundos (1-30, padrão: 10)
array
Cabeçalhos HTTP para enviar com a solicitação
array
Parâmetros que a IA extrairá da conversa e enviará para o endpoint

Campos de resposta

string
Mensagem de sucesso
object
O objeto da ferramenta criada

Anexando Ferramentas a Assistentes

Após criar uma ferramenta, você precisa anexá-la a um assistente para usá-la durante as chamadas. As ferramentas são gerenciadas através da API de Assistente:
  • Criar Assistente - Use o parâmetro tool_ids para anexar ferramentas ao criar um assistente
  • Atualizar Assistente - Use o parâmetro tool_ids para adicionar, remover ou substituir ferramentas em um assistente existente