Esempio di strumenti API: agente meteorologico AI

Gli magneti AI possono comunicare con qualsiasi endpoint API che desideri. Che si tratti di Zapier, The New York Times, Zendesk, del tuo CRM o di qualsiasi altra piattaforma con accessibilità API, i nostri agenti possono connettersi senza problemi.

Scatena la tua creatività con strumenti in linguaggio naturale per recuperare le previsioni del tempo, trovare gli ultimi articoli di notizie o persino inviare un'e-mail a un amico! Le possibilità sono ampie quanto la tua immaginazione.

In questo esempio, configureremo un agente AI per le previsioni meteorologiche della città che utilizzerà API AccuWeather di:

  1. Ottieni la chiave di posizione della città dalla richiesta dell'utente tramite la richiesta API di posizione di AccuWeather
  2. Utilizza questa chiave di posizione per ottenere le previsioni per quella città tramite la richiesta API Forecast di AccuWeather

Configurazione dello strumento API

  1. Vai su "Training Center", quindi sulla scheda "API Tools" per creare un nuovo strumento

  2. Dategli un nome e una descrizione. Tieni presente che la descrizione viene utilizzata dal chatbot AI per capire quando utilizzare questo strumento, quindi sii descrittivo!

  3. L'API Locations di AccuWeather richiede un parametro "query" per cercare la città e restituire la chiave della posizione, quindi aggiungiamo un parametro "query" nella scheda "Parametri". Immettere "query" nel campo di input e fare clic sul pulsante "Aggiungi parametro".

  4. Nel campo “Descrizione”, descrivi in ​​linguaggio naturale come l'IA dovrebbe capire cosa aspettarsi, in questo caso inseriremo “nome della città”. Questo è un parametro obbligatorio per questo strumento, quindi abilita l'interruttore "parametro richiesto".

  5. Nella scheda "Azione", inseriremo l'endpoint API dalle API Locations di AccuWeather (utilizza la tua chiave API di AccuWeather se desideri utilizzare questo endpoint):
    http://dataservice.accuweather.com/locations/v1/cities/search?apikey=XXXXXX&q={{query}}

  6. Aggiungeremo ora un nuovo strumento per utilizzare la chiave di posizione ricevuta dallo strumento precedente

  7. Le API di previsione di AccuWeather richiedono un parametro "locationkey", quindi aggiungiamo quel parametro per questo strumento

  8. Non dimenticare di inserire una descrizione di ciò che l'IA deve aspettarsi. Questo è un parametro obbligatorio per questo strumento, quindi abilita l'interruttore "parametro richiesto".

  9. Inserisci l'endpoint API Forecast di AccuWeather nella scheda "Azione":
    http://dataservice.accuweather.com/forecasts/v1/daily/5day/{{locationkey}}?apikey=XXXXXX

Configurazione dell'agente AI

  1. Crea un nuovo Chatbot, scegli il tipo "Agente AI".

  2. Nella scheda "Strumenti", assegna gli strumenti che abbiamo creato a questo chatbot

  3. Tutto fatto! Chatbot ora può prevedere il tempo su richiesta