Cosa sono i servizi collegati
Un servizio collegato è un riferimento con nome a uno dei tuoi endpoint HTTP. Ogni voce ha:
- un Service ID: il breve identificativo che le azioni usano per chiamarlo (ad esempio
orders_api); - un Method:
GET,POST,PUToDELETE; - un URL: l’endpoint a cui viene inviata la richiesta;
- un header di autenticazione facoltativo e il relativo valore segreto.
Quando un’azione invoca un servizio collegato, il backend di Seekdown effettua la richiesta per conto dell’assistente, allega l’header di autenticazione se ne hai configurato uno e restituisce la risposta alla conversazione. Poiché l’assistente si riferisce al servizio solo tramite il suo id, l’URL reale e le eventuali credenziali restano sul server: non fanno mai parte della configurazione pubblica dell’assistente che il widget scarica.
Quando usare un servizio collegato
- Recuperare dati in tempo reale che il dataset non può contenere (lo stato di un ordine, il livello delle scorte o il
saldo di un conto) in risposta alla domanda di un utente.
- Inviare una richiesta ai tuoi sistemi (creare un ticket, registrare un interesse, avviare un
flusso di lavoro) da un modulo mostrato dall’assistente.
- Tenere una chiave API fuori dalla pagina: vuoi chiamare un endpoint autenticato senza
esporre la chiave nel codice front-end.
Documenti correlati
- Personalizzazione avanzata: dove si trovano le azioni e l’helper
executeProxyRequest.
- Moduli dell’assistente: raccogli gli input che l’assistente può inviare a un servizio collegato.