Crea un servicio vinculado
Los servicios vinculados se configuran por asistente, junto al resto de sus ajustes.
Antes de empezar
- Ten ya creado un asistente. Consulta [Crea un asistente
perfecto](build-assistant.md) si aún no tienes uno.
- Conoce el endpoint al que quieres llamar: su URL, su método y (si la necesita) la cabecera
y el valor que se usan para autenticarse.
Pasos
- Abre tu asistente y ve a la pestaña Linked services.
- Elige Add linked service.
- En el diálogo, rellena:
- Service ID: un identificador corto y único que usarán tus acciones (p. ej.,
orders_api). - Method:
GET,POST,PUToDELETE. - URL: el endpoint completo, empezando por
https://.
- (Opcional) En Authentication, define un Header name (como
Authorization)
y su Secret value. Consulta Autenticar peticiones.
- (Opcional) En Headers, añade cabeceras de la petición cuyos valores pueden incluir marcadores
{{params.x}}. Consulta Pasar valores dinámicos.
- Pulsa Save service y después Apply en la configuración del asistente.
Comprueba el resultado
El servicio aparece en la lista con su método, su endpoint y —si lo añadiste— una etiqueta Auth. Lanza la acción que lo llama (o el formulario conectado a él) y confirma que la respuesta aparece en la conversación.
Los ID deben ser únicos
Cada service id identifica su propia configuración y su credencial, así que dos servicios no pueden compartir id. El editor avisa del conflicto antes de guardar.
Solución de problemas
- Save está desactivado: hay un campo obligatorio (Service ID o URL) vacío, o la URL no
empieza por http:// o https://.
- "Set an auth header name to attach the secret to.": has introducido un valor secreto pero
has dejado vacío el nombre de la cabecera. Añade el nombre de la cabecera o borra el secreto.
Documentación relacionada
- Llamar a un servicio vinculado: conecta una acción a él.
- Autenticar peticiones: añade una credencial que se queda en el servidor.