Social Intents Social Intents
Preços Agências
Login Teste gratuito

Ação de API personalizada

A Ação de API personalizada permite que seu agente de IA no Social Intents consulte APIs externas e exiba o resultado diretamente na conversa. Isso permite pesquisas, atualizações ou ações em tempo real acionadas pelo usuário, como verificar o status do pedido, obter dados da conta ou enviar um formulário.

Configuração de ação personalizada da solicitação da API do clima

Geral

  • Nome da ação: Forneça um nome descritivo, como get_weather ou upgrade_subscription.
  • Quando usar: Descreva quando essa ação da API deve ser acionada. Inclua exemplos de frases que a IA deve reconhecer e o tipo de informação que a API fornece em resposta.

Configuração da API

  • Tipo de ação: Chamar solicitação de API
  • Nome da ação: Um nome descritivo como get_weather
  • Quando usar: Exemplo: "Essa ação é acionada quando um visitante pergunta sobre o clima em qualquer cidade."
  • Resposta acionada: Exemplo: "Claro, deixe-me ver a previsão do tempo para você".
  • Coleta entradas de dados para ação: Quaisquer parâmetros na solicitação, como cidade ou apiKey
  • Solicitação de API: O URL do endpoint, usando variáveis, se necessário (por exemplo https://api.openweathermap.org/data/2.5/weather?q={{city}}&appid={{apikey}}&units=imperial).
  • Método da API: Escolha GET, POST, PUT ou DELETE.

Solicitação de API de ação personalizada de IA

Exemplos de casos de uso

Assinatura de upgrade

Neste exemplo, o agente de IA ajuda os usuários a atualizar seu plano. A API recebe o status atual e o nome do novo plano. O ponto de extremidade é:
https://api.socialintents.com/upgrade-subscription?status={{status}}&plan={{plan}}

Quando um usuário diz "Quero fazer upgrade para premium", a IA usa essa API para processar a solicitação e confirmar o upgrade.

Pesquisa de clima

Essa ação extrai dados meteorológicos de uma determinada cidade usando uma solicitação GET para:
https://api.openweathermap.org/data/2.5/weather?q={{city}}&appid={{apikey}}&units=imperial

Quando um usuário diz "What's the weather in New York?" (Qual é o clima em Nova York?), o agente de IA recupera e resume a resposta.