Ir al contenido

https://documentacion.onelyra.com/funcionalidades/capacidades/ejecutar/servicio/ · Actualizado el 25 de octubre de 2026

Servicio

Qué es
Ejecuta una operación (consultar, crear, actualizar) en un sistema conectado, con lo que la conversación ya sabe.
Para quién
Quien escribe capacidades.
Dónde vive
En el documento de una capacidad, desde el catálogo (/).

El servicio es donde la conversación toca un sistema: crea el caso, consulta el estado, actualiza el correo. Lo que ejecuta es una operación ya configurada en Sistemas; el bloque solo decide cuándo corre y con qué datos. Cómo se configura una operación está en Las operaciones REST.

El formulario de un servicio: la operación elegida, lo que le entrega y las dos decisiones, ofrecer los resultados y seguir si falla

CampoQué es
Qué operación ejecutaUna de las operaciones de los sistemas conectados.
Lo que usaLos datos que la operación necesita. Vacío: salen de una pregunta anterior o de lo que ya se sabe; también se puede escribir un texto fijo o un {{dato}}.
Ofrecer los resultados como opcionesSi la operación devuelve una lista (los casos abiertos), cada resultado se vuelve una opción tocable que abre otra capacidad con los datos de ese resultado. Con «puede elegir varios», al volver se ofrece lo que queda.
Si el sistema no puede, seguir con lo de abajoApagado (lo normal): se dice el error y la conversación termina ahí. Encendido: sigue, aunque lo de abajo correrá sin lo que el servicio iba a traer.

Léalo así: casi siempre basta con elegir la operación. Los datos los trae la conversación y el acuse lo trae la operación.

Una operación que escribe en el sistema se confirma antes de ejecutarse; una que solo consulta, no. Lo decide la operación (si lo tiene marcado) o su método (crear, actualizar y borrar confirman; consultar no). La confirmación resume lo que la persona respondió:

Revisa que esté bien: • Solicitante: Ana Pérez • Descripción: se cayó la red del piso 3 • Urgencia: alta O escribe cancelar y empezamos de nuevo.

Solo un sí claro ejecuta. Un no cancela y la conversación termina sin tocar nada. Lo que no se entiende se vuelve a preguntar; a la segunda vez que no se entiende, ELYRA dice que no hizo nada y termina.

ResultadoLo que oye la persona
Salió bienEl mensaje de éxito de la operación, con sus datos («Quedó el caso INC000123»). Una consulta sin mensaje propio no dice nada: deja los datos para los bloques siguientes.
Faltó un dato«Me falta un dato» y la conversación termina: la operación usaba algo que nadie llenó. No se llama al sistema.
No se supo si quedóSolo en una operación que escribe: la petición llegó al sistema y no volvió respuesta a tiempo, o se cortó a medias. Si la operación tiene una comprobación configurada, ELYRA la usa para averiguarlo; si no, le dice a la persona que lo envió sin confirmación y que no lo repita.
FallóEl mensaje de error de la operación, o el genérico con lo que dijo el sistema. También cuando el sistema no acepta la conexión (la petición no llegó) y cuando una consulta no responde: leer no deja nada a medias.

Lo que la operación devuelve (el número del caso, el estado) queda como datos de la conversación para los bloques de abajo.

Y cómo le fue queda en Resultado del servicio ({{resultado_servicio}}): ok, fallo o sin_respuesta. Un bloque Caminos puede tomar un camino u otro según ese valor. Para decidir sobre un fallo, el servicio tiene que tener encendido «Si el sistema no puede, seguir con lo de abajo»: apagado, la conversación termina al fallar y lo de abajo solo ve ok.

Con «ofrecer» encendido, una lista se vuelve un menú: cada fila tiene la cara que se le dé («{{numero}} — {{estado}}») y al tocarla corre la capacidad destino con los datos de esa fila. La persona también puede escribir la etiqueta o, con la IA, describirla.

  • La puerta está apagada o fallando: el sistema de la operación está inactivo o su última prueba falló. Fallando es rojo.
  • Escribe sin comprobación: la operación crea o cambia algo y no tiene cómo averiguar si quedó cuando el sistema no responde.
  • Usa un dato que nada produce: la petición cita un dato que ninguna pregunta, guardado ni servicio anterior llena.
  • Un dato del mensaje de éxito no se observa en lo que el sistema devuelve de verdad, y el servicio es lento frente a los demás.
  • La operación que ejecuta se configura en Sistemas y operaciones.
  • Para responder preguntas libres desde documentos y consultas, sin confirmación, Consultar.
  • Para vigilar un dato del sistema después, Poner un vigía.
  • Dentro de un lote Por cada fila el servicio no pide confirmación: la dio quien lanzó el lote.

Desliza la imagen para verla entera.