--- id: "fluxos.orquestracao-conceito" titulo: "Orquestación: el maestro y las tarjetas enlazadas" resumo: "Entiende cómo organiza Elyra varios agentes: el maestro, los hijos enlazados a él en el Canvas y qué significa un enlace." idioma: "es" tipo: "conceito" categoria: "agentes" aplicavelDesde: "0.0.16" capabilities: ["orchestration.peers.discover"] estadoEditorial: "aprovado" nivelEvidencia: "artefato-distribuido" refFonte: "27574c339b58316408f6be2d62169d59041d07bf" revisaoFonte: "2026-09-24" revisor: "mantenedor (v1, 2026-10-03)" rota: "/docs/es/fluxos/orquestracao-conceito/" fonte: "pt-br/fluxos/orquestracao-conceito.md" caminhoPublico: "docs/publica/es/fluxos/orquestracao-conceito.md" hashFonte: "sha256:238910b0b28f1a704ef3f106c94df95a59fd50ada824f1e00471ba19979e8772" hashDestaPagina: "sha256:55b2cc2a971b140386a8421448eac69175a84409f4c8fbdb52e85b6177a09a9b" traducaoAssistidaPorIA: true traducaoDesatualizada: false corpoRetido: false --- Trabajar con varios agentes de código en paralelo plantea una pregunta práctica: **quién coordina a quién**. En Elyra esa respuesta no es un modo que se enciende ni un panel separado — está en la propia conversación. ## El maestro La tarjeta de conversación principal de un proyecto **es** el orquestador. No es un tipo especial de tarjeta, ni un botón de «repartir tarea»: el maestro crea los hijos que necesite conversando, con las skills y la línea de comandos de Elyra, y el Canvas solo muestra lo que él creó. Cuando un hijo nace así, aparece en el Canvas **enlazado al maestro por una línea**, con el estado en vivo. Es esa línea la que hace que el Canvas sea un mapa del trabajo en curso, y no una pila de tarjetas. ## Enlazar dos tarjetas a mano También puedes enlazar tarjetas por tu cuenta, arrastrando de una tarjeta hasta otra. El enlace queda dibujado y persistido, y es lo que define quién alcanza a quién. - **Enlazar** dos tarjetas que ya están enlazadas no crea una segunda línea: el panel avisa. - **Soltar fuera de una tarjeta** no crea nada: el panel avisa que era necesario soltar sobre otra tarjeta. - **Enlazar una tarjeta consigo misma** se rechaza. - **Una tarjeta sin sesión activa** no puede ser extremo de un enlace de agente — sin sesión, no hay a quién entregar el mensaje. - **Quitar el enlace** es clic con el botón derecho sobre la línea, con confirmación. La línea desaparece; las tarjetas y las sesiones siguen como están. Un enlace entre **dos agentes** los hace pares, que pueden intercambiar mensajes. Un enlace entre un **agente y un recurso** — una nota, un archivo, una página del navegador, un dispositivo — es contexto: le dice al agente dónde mirar, no crea un par. ## El aviso al enlazar En **Ajustes → Orquestación** existe **Avisar al enlazar tarjetas**. Viene **desactivado**. - **Desactivado:** la línea en el Canvas es todo el enlace. El agente no es avisado. - **Activado:** al enlazar, el agente recibe **una línea** en su canal de mensajes, diciendo el tipo, el nombre del recurso y dónde mirar. Nunca el contenido — el agente lee el recurso bajo demanda, si quiere. El gesto nunca queda bloqueado por el aviso: el hilo se dibuja de todos modos. ## Descubrir quién está a tu alcance Un agente descubre los vecinos con: ```bash elyra orchestration peers ``` La respuesta lista las relaciones y las direcciones alcanzables, y la dirección de cada una: | Dirección | Significado | |---|---| | `parent` | La tarjeta que creó este agente | | `child` | Una tarjeta que este agente creó | | `peer` | Un enlace dibujado a mano | Dos cosas importantes sobre esa consulta: 1. **Es una fotografía.** El Canvas cambia mientras el trabajo ocurre: el enlace que existía en la última consulta puede haberse deshecho, y otro puede haber aparecido. Consultar antes de delegar es la regla. 2. **Una tarjeta sin sesión aparece en la lista con dirección nula.** Sigue allí, marcada como sin sesión — no recibe mensaje hasta tener una sesión de nuevo. ## Dónde se configura esto En **Ajustes → Orquestación** están los controles del ciclo de vida de los agentes: - **Wake the orchestrator automatically** — en cada intervalo, Elyra envía un mensaje a las tarjetas con rol de orquestador, aunque el agente esté trabajando. Viene **activado**. - **Intervalo entre despertares** — en minutos, con un mínimo y un techo; vale solo mientras el control de arriba está activado. - **Despertar cuando una tarjeta hija termine el trabajo** — después del fin confirmado de un agente, Elyra espera cerca de un segundo y despierta solo a quien **puede ser despertado** y está enlazado a él en el mismo workspace. ## Alcance y límites - **La orquestación no es un modo.** No existe un botón de «repartir tarea» que encender: el maestro delega conversando. Si buscas ese botón, no existe. - **Un enlace es dirección, no permiso.** Estar enlazado significa alcanzar; lo que el agente **puede hacer** es asunto de rol, no de línea en el Canvas. - **El enlace vale dentro del workspace.** Un agente no alcanza una tarjeta de otro workspace. ## Próximos pasos - [Mensajes entre agentes](/docs/es/fluxos/orquestracao-mensagens/)