Exemplo de ferramentas API: agente meteorológico AI

Os agnets de IA podem se comunicar com qualquer endpoint de API que você desejar. Seja Zapier, The New York Times, Zendesk, seu CRM ou qualquer outra plataforma com acessibilidade API – nossos agentes podem se conectar perfeitamente.

Liberte a sua criatividade com ferramentas de linguagem natural para recuperar a previsão do tempo, encontrar as últimas notícias ou até mesmo enviar um e-mail para um amigo! As possibilidades são tão amplas quanto a sua imaginação.

Neste exemplo, configuraremos um agente de IA de previsão do tempo da cidade que utilizará API AccuWeather para:

Obtenha a chave de localização da cidade a partir da solicitação do usuário por meio da solicitação da API de localização do AccuWeather
Use esta chave de localização para obter a previsão para aquela cidade por meio da solicitação da API de previsão do AccuWeather

Configurando a ferramenta API

Vá para “Centro de Treinamento” e depois para a guia “Ferramentas API” para criar uma nova ferramenta
Dê um nome e uma descrição. Observe que a descrição é usada pelo chatbot AI para entender quando usar esta ferramenta, então seja restritivo!
A API de locais do AccuWeather requer um parâmetro de 'consulta' para pesquisar a cidade e retornar a chave de localização, então vamos adicionar um parâmetro de 'consulta' na guia “Parâmetros”. Digite “consulta” no campo de entrada e clique no botão “Adicionar parâmetro”
No campo “Descrição”, descreva em linguagem natural como a IA deve entender o que esperar, neste caso inseriremos “nome da cidade”. Este é um parâmetro obrigatório para esta ferramenta, portanto habilite a alternância “parâmetro obrigatório”.
Na guia “Ação”, inseriremos o endpoint da API das APIs de locais do AccuWeather (use sua própria apikey do AccuWeather se desejar usar este endpoint):
http://dataservice.accuweather.com/locations/v1/cities/search?apikey=XXXXXX&q={{query}}
Agora adicionaremos uma nova ferramenta para utilizar a chave de localização recebida da ferramenta anterior
As APIs de previsão do AccuWeather exigem um parâmetro 'locationkey', então vamos adicionar esse parâmetro para esta ferramenta
Não se esqueça de inserir uma descrição do que a IA precisa esperar. Este é um parâmetro obrigatório para esta ferramenta, portanto habilite a alternância “parâmetro obrigatório”.
Insira o endpoint da API de previsão do AccuWeather na guia “Ação”:
http://dataservice.accuweather.com/forecasts/v1/daily/5day/{{locationkey}}?apikey=XXXXXX