Panoramica sull'API watsonx Assistant

Puoi utilizzare le API REST watsonx Assistant, e gli SDK corrispondenti, per sviluppare le applicazioni che interagiscono con il servizio.

Applicazioni client

Per creare un assistente virtuale o un'altra applicazione client che comunichi con un assistente in fase di esecuzione, utilizzare l'API v2. Puoi sviluppare un client rivolto al cliente che può essere distribuito per uso di produzione, un'applicazione che broker la comunicazione tra un assistente e un altro servizio o un'applicazione di test.

Utilizzando l'API runtime v2 per comunicare con il tuo assistente, la tua applicazione può trarre vantaggio dalle seguenti funzioni:

  • Gestione automatica dello stato. L'API di runtime v2 gestisce ogni sessione con un utente, memorizzando e mantenendo tutti i dati di contesto necessari all'assistente per una conversazione completa.

  • Facilità di distribuzione degli assistenti. Oltre a supportare i client personalizzati, un assistente può essere distribuito facilmente ai canali di messaggistica popolari come Slack e Facebook Messenger.

  • Controllo della versione. È possibile salvare un'istantanea del contenuto e collegare l'assistente a quella versione specifica. Puoi quindi continuare ad aggiornare la tua versione di sviluppo senza influire sull'assistente di produzione.

  • Funzionalità di ricerca. L'API di runtime di v2 può essere utilizzata per ricevere risposte dall'integrazione della ricerca. Quando viene inoltrata una query a cui il tuo assistente non può rispondere, l'integrazione della ricerca può individuare la risposta migliore dalle origini dati configurate.

Per ulteriori informazioni, vedi la Guida di riferimento APIwatsonx Assistant v2.

L'API watsonx Assistant v1 supporta il metodo /message che invia l'input dell'utente direttamente all'area di lavoro utilizzata da una finestra di dialogo. L'API di runtime v1 è supportata principalmente per compatibilità. Se usi il metodo v1 /message, devi implementare la tua gestione dello stato e non puoi usufruire del controllo della versione o di qualsiasi altra funzione di un assistente.

Applicazioni di creazione

L'API v1 fornisce metodi che consentono a un'applicazione di creare o modificare le abilità di dialogo, in alternativa alla costruzione grafica di un'abilità tramite la classica interfaccia utente Watson Assistant. Un'applicazione di creazione utilizza l'API per creare e modificare capacità, intenti, entità, nodi di dialogo e altre risorse che compongono una capacità di dialogo. Per ulteriori informazioni, consultare il Riferimento API v1.

I metodi di creazione v1 creano e modificano gli spazi di lavoro piuttosto che le competenze. Uno spazio di lavoro è un contenitore per il dialogo e i dati di addestramento (ad esempio intenti e entità) all'interno di una capacità di dialogo. Se si crea un nuovo spazio di lavoro utilizzando l'API, esso appare come una nuova abilità di dialogo nell'interfaccia utente classica Watson Assistant.

Per un elenco dei metodi API disponibili, vedi Riepilogo dei metodi API.