Las capacidades

Una capacidad es una cosa completa que ELYRA sabe hacer: registrar una falla, consultar un caso, dar de alta a alguien, pasar la conversación a una persona del equipo. Todo lo que una persona vive conversando con ELYRA es una capacidad corriendo, y toda capacidad se escribe en un solo sitio: su documento.

El documento se lee de arriba abajo, en el orden en que ocurre la conversación, y se compone de bloques. Cada bloque hace una cosa: pregunta, dice, decide, ejecuta, avisa, mide. Esta página explica la capacidad como unidad y lleva a un artículo por cada bloque. Por qué un documento y no un diagrama de cajas y flechas lo cuenta El documento y las capacidades.

Cómo nace y qué tiene

Una capacidad se crea con dos cosas obligatorias: un nombre y un propósito, una línea que dice qué resuelve, escrita con las palabras de quien la va a usar. El propósito no es decoración: es lo que lee quien llega al documento y lo que usa ELYRA para decidir cuándo ofrecerla.

Qué tiene	Para qué sirve
Nombre y propósito	Cómo se llama y qué resuelve. Dos capacidades con el mismo nombre no se distinguen en los menús; el documento lo avisa y ofrece unificarlas.
Dominio	Una etiqueta libre («Mesa de ayuda», «Recursos humanos») para agrupar la lista de capacidades.
Exposición	Pública: se le puede ofrecer a la gente en un menú. Interna: solo otras capacidades la llaman; nunca aparece en un menú ni la ofrece la IA de la puerta.
Voz	Con qué palabras habla: las de su puerta, o una voz propia (otro idioma, otro tono).
Acepta y produce	Su contrato: qué datos necesita para trabajar y qué datos deja. ELYRA lo deriva de los bloques; se puede declarar a mano, y entonces lo declarado manda y el documento mide si se cumple.
Los bloques	Lo que hace, en orden.

Léalo así: el nombre, el propósito y los bloques son la capacidad; lo demás son perillas que se tocan cuando hace falta.

Por dónde se llega a una capacidad

Una capacidad no se «arranca»: la gente llega a ella por alguno de estos caminos, y el documento lo enseña en Usada en.

• La puerta. Cada canal tiene una capacidad inicial: la que recibe a quien escribe. Es la conversación entera vista desde su entrada.
• Un menú. El bloque Ofrecer opciones de otra capacidad la ofrece como una opción.
• Una llamada. Otra capacidad la llama a secas (Llamar otra capacidad), bajo una condición (Escenario, Caminos) o una vez por fila de un archivo (Por cada fila).
• La IA de la puerta. Si la puerta tiene su portero encendido, lee lo que la persona escribe y le ofrece la capacidad pública que corresponde.
• Una carta. Un aviso programado o disparado arranca una capacidad hacia una audiencia.
• Un comando. Una palabra con barra (/estado) que corre una capacidad.
• El atajo de las costumbres. A quien viene siempre a lo mismo, ELYRA le ofrece esa capacidad al saludar (ver Las costumbres).

Los bloques

El documento se escribe en la línea de abajo: un texto que termina en ? se vuelve una pregunta; [[ llama otra capacidad; / abre el catálogo con todos los bloques. Cada bloque tiene su ⚙ para ajustarlo, se sube, se baja y se quita. Los artículos de cada uno:

Hace	Bloques
Preguntar y decir	Pregunta · Mensaje · Guardar un dato · Nota
Decidir	Ofrecer opciones · Escenario · Caminos
Ejecutar	Servicio · Consultar
Encadenar	Llamar otra capacidad · Por cada fila · Pasar a una persona
Avisar y vigilar	Avisar · Poner un vigía · Mis vigías · Cancelar un vigía · Esperar el evento
Medir	Calificar
Diseñar con IA	Proponerlo con la IA: no es un bloque de la conversación, es el asistente que propone bloques.

La IA no es un bloque: es una capa que se enciende por puerta y ayuda a entender lo que la gente escribe. Ver La IA en ELYRA.

Tres cosas valen para todos los bloques:

• Los datos. Lo que una pregunta guarda queda con un nombre (numero_caso) y cualquier bloque posterior lo usa escribiendo {{numero_caso}}; al escribir / en un campo se eligen de la lista. Hay datos que siempre están: quién escribe (remitente), por qué canal, la fecha y la hora en el reloj de la organización.
• La voz. Cada texto que ve la persona se puede cambiar: lo que dice un bloque, la voz de la capacidad y la de la puerta se apilan, y gana lo más específico.
• Las llaves sin valor no salen. Si un texto cita {{algo}} que la conversación no tiene, la llave se quita antes de enviar: la persona nunca lee una llave cruda.

Terminar la conversación no es un bloque: es una capacidad de fábrica, Terminar la conversación, que se llama como cualquier otra y se despide con el texto del catálogo o con uno propio. Es la única que no se puede borrar.

Lo que el documento observa

Encima de los bloques está la salud: una lista de lo que el documento ve que puede fallar, cada hallazgo con su testigo y su explicación. Una pregunta cuya respuesta nadie usa, un servicio que escribe en un sistema caído, una capacidad ofrecida sin los datos que necesita, un ciclo entre capacidades, un menú con más opciones de las que el canal pinta. Los rojos son cosas que fallan hoy; los ámbar, cosas que conviene mirar. Algunos hallazgos preguntan «¿sabes por qué?» y la respuesta queda guardada como un saber de la capacidad. La lista completa, con qué significa cada uno y cómo se apaga, está en La salud del documento.

Probar y publicar

El panel Ensayo, a la derecha del documento, conversa con la capacidad tal como está guardada, sin tocar la conversación de nadie. En modo simulado los servicios responden con su última respuesta real, sin llamar al sistema; en modo real, lo que se confirme queda registrado de verdad.

Todo cambio en un documento se guarda en el acto, pero la gente vive lo publicado: la puerta de cada canal tiene su línea de versiones, y una conversación que empieza queda fijada a la versión publicada en ese momento hasta que termina, aunque alguien publique otra a mitad. Publicar pide una línea que diga qué cambió y por qué; volver a una versión anterior crea una versión nueva, nunca reescribe la historia. Dónde se ve y cómo se compara está en El documento y las capacidades.

Lo que la protege por dentro

• Una capacidad que corre treinta bloques seguidos sin esperar a nadie se corta: es un ciclo, no una conversación.
• Como mucho hay veinticinco capacidades abiertas a la vez (A llama a B, B llama a C…). Un bucle bien escrito —una capacidad que se vuelve a llamar para reintentar— no las acumula.
• Borrar una capacidad que otra usa no se puede: el documento dice quién la usa. Primero se quita esa referencia.