Crea un servizio collegato
I servizi collegati si configurano per assistente, insieme alle sue altre impostazioni.
Prima di iniziare
- Devi aver già creato un assistente. Vedi [Crea un assistente
perfetto](build-assistant.md) se non ne hai ancora uno.
- Conosci l’endpoint che vuoi chiamare: URL, metodo e (se serve) l’header
e il valore usati per l’autenticazione.
Passaggi
- Apri il tuo assistente e vai alla scheda Linked services.
- Scegli Add linked service.
- Nella finestra di dialogo, compila:
- Service ID: un identificativo breve e univoco che le tue azioni useranno (ad es.
orders_api). - Method:
GET,POST,PUToDELETE. - URL: l’endpoint completo, che inizia con
https://.
- (Facoltativo) In Authentication, imposta un Header name (come
Authorization)
e il relativo Secret value. Vedi Autentica le richieste.
- (Facoltativo) In Headers, aggiungi header di richiesta i cui valori possono includere segnaposto
{{params.x}}.
Vedi Passa valori dinamici.
- Save service, poi Apply per applicare la configurazione dell’assistente.
Verifica il risultato
Il servizio compare nell’elenco con il metodo, l’endpoint e, se ne hai aggiunto uno, un badge Auth. Attiva l’azione che lo chiama (o il modulo collegato) e verifica che la risposta compaia nella conversazione.
Gli ID devono essere univoci
Ogni service id identifica la propria configurazione e le proprie credenziali, quindi due servizi non possono condividere un id. L’editor segnala il conflitto prima del salvataggio.
Risoluzione dei problemi
- Il salvataggio è disattivato: un campo obbligatorio (Service ID o URL) è vuoto, oppure l’URL non
inizia con http:// o https://.
- "Set an auth header name to attach the secret to.": hai inserito un valore segreto ma
lasciato vuoto il nome dell’header. Aggiungi il nome dell’header oppure cancella il segreto.
Documenti correlati
- Chiama un servizio collegato: collega un’azione al servizio.
- Autentica le richieste: aggiungi una credenziale che resta lato server.