Agent orchestration
Equipos de agentes de IA con reglas que ningún modelo puede saltarse AI agent teams with rules no model can skip
Describes el equipo en unos pocos ficheros: quién participa, quién puede encargar qué a quién, quién aprueba cada escritura y cuándo está terminado el trabajo. orq lo hace cumplir en cada mensaje y en cada llamada a una herramienta, y apunta todo lo que pasa. Describe the team in a few files: who takes part, who may ask whom for what, who approves each write and when the work is done. orq enforces it on every message and every tool call, and records everything that happens.
El problemaThe problem
Hoy, las reglas de un equipo de agentes viven en sus promptsToday, an agent team's rules live in its prompts
Nada las garantizaNothing guarantees them
Un prompt que dice «no devuelvas dinero sin permiso» se cumple casi siempre. Hasta que un correo con instrucciones inyectadas dice lo contrario.A prompt that says “never refund without permission” is usually obeyed. Until an email with injected instructions says otherwise.
Cada equipo es un proyecto nuevoEvery team is a new project
El código que une a los agentes de un equipo no sirve para el siguiente.The glue code of one team doesn't carry over to the next.
No se ve qué pasóYou can't see what happened
Cuando algo sale mal, es difícil saber qué recibió cada agente, qué hizo y por qué el proceso avanzó o se paró.When something goes wrong, it's hard to tell what each agent received, what it did and why the process moved on or stalled.
Cómo funcionaHow it works
Piensa en la red como en una oficinaThink of the network as an office
Cada agente tiene su despacho y solo las llaves que le da la red. Todas las puertas dan al pasillo, y en el pasillo está orq: ningún encargo pasa de un despacho a otro sin que lo compruebe y lo apunte en el libro de registro.Each agent has its own office and only the keys the network gives it. Every door opens onto the hallway, and orq stands in the hallway: no request goes from one office to another without orq checking it and writing it in the logbook.
Arrastra para girar · pulsa a alguien para ver su fichaDrag to rotate · tap anyone to see their card
Esta escena necesita WebGL, y tu navegador no lo tiene activado. El libro de registro cuenta la misma ejecución.This scene needs WebGL, which your browser has turned off. The logbook tells the same run.
Una red que resuelve reclamaciones de clientes, con cinco agentes. Pulsa «Ver una ejecución» para seguir una reclamación de principio a fin.A network that resolves customer claims, with five agents. Press “Watch a run” to follow one claim from start to finish.
El planoThe blueprint
La oficina se describe en un fichero que cualquiera puede leerThe office is described in a file anyone can read
La oficina de arriba es este fichero. Se revisa y se versiona como cualquier código, y orq lo hace cumplir tal como está escrito.The office above is this file. It is reviewed and versioned like any code, and orq enforces it exactly as written.
# network.yaml (fragmento)
network: reclamaciones
description: Resuelve la reclamación de un cliente y, si procede, emite un reembolso.
participants:
cliente: { kind: external }
coordinador: { agent: agents/coordinador.yaml }
investigador: { agent: agents/investigador.yaml }
especialista: { agent: agents/especialista.yaml }
redactor: { agent: agents/redactor.yaml }
revisor: { agent: agents/revisor.yaml }
messages:
reclamacion: { pedido: string, descripcion: string }
consulta: { pregunta: string, pedido: string }
hallazgos: { resumen: string, fuentes: [string] }
encargo: { reclamacion: reclamacion, hallazgos: [string] }
borrador: { texto: string, importe: number }
propuesta: { pedido: string, texto: string, importe: number }
dictamen: { decision: aprobar | cambios, observaciones: [string] }
respuesta: { texto: string, importe: number, reembolso: string? }
links:
- { from: cliente, to: coordinador, request: reclamacion, result: respuesta }
- { from: coordinador, to: investigador, request: consulta, result: hallazgos }
- { from: coordinador, to: especialista, request: consulta, result: hallazgos }
- { from: coordinador, to: redactor, request: encargo, result: borrador }
- { from: coordinador, to: revisor, request: propuesta, result: dictamen }
coordination:
finish:
approved_by: revisor
verdict: { decision: aprobar }
same_fields: [texto, importe]
approvals:
- tool: pedidos.emitir_reembolso
by: revisor
verify_with: investigador
limits:
budget_usd: 2
hooks:
- hooks/limite-reembolsos.ts # ningún reembolso de más de 500 €
# network.yaml (excerpt)
network: claims
description: Resolves a customer claim and, when needed, issues a refund.
participants:
customer: { kind: external }
coordinator: { agent: agents/coordinator.yaml }
investigator: { agent: agents/investigator.yaml }
specialist: { agent: agents/specialist.yaml }
writer: { agent: agents/writer.yaml }
reviewer: { agent: agents/reviewer.yaml }
messages:
claim: { order: string, description: string }
query: { question: string, order: string }
findings: { summary: string, sources: [string] }
brief: { claim: claim, findings: [string] }
draft: { text: string, amount: number }
proposal: { order: string, text: string, amount: number }
verdict: { decision: approve | changes, remarks: [string] }
answer: { text: string, amount: number, refund: string? }
links:
- { from: customer, to: coordinator, request: claim, result: answer }
- { from: coordinator, to: investigator, request: query, result: findings }
- { from: coordinator, to: specialist, request: query, result: findings }
- { from: coordinator, to: writer, request: brief, result: draft }
- { from: coordinator, to: reviewer, request: proposal, result: verdict }
coordination:
finish:
approved_by: reviewer
verdict: { decision: approve }
same_fields: [text, amount]
approvals:
- tool: orders.issue_refund
by: reviewer
verify_with: investigator
limits:
budget_usd: 2
hooks:
- hooks/refund-limit.ts # no refund above 500 €
✓ La red completa pasa orq validate y se ejecuta con agentes simulados.✓ The full network passes orq validate and runs with simulated agents.
- 1
Los despachosThe offices
Quién participa: cinco agentes y quien lanza el trabajo.Who takes part: five agents and whoever starts the work.
- 2
Los mensajesThe messages
La forma de cada encargo. Un borrador sin importe no llega a su destino: vuelve a quien lo envió con el motivo.The shape of each request. A draft without an amount never arrives: it goes back to its sender with the reason.
- 3
Las puertasThe doors
Quién puede encargar qué a quién. El redactor no tiene puerta hacia el cliente, así que no puede escribirle.Who may ask whom for what. The writer has no door to the customer, so it can't write to them.
- 4
Cuándo se entregaWhen it's delivered
Solo una propuesta que el revisor aprobó, con el mismo texto y el mismo importe.Only a proposal the reviewer approved, with the same text and the same amount.
- 5
La firmaThe signature
El reembolso no se ejecuta sin el revisor. Si no se sabe si se hizo, lo comprueba el investigador.The refund doesn't run without the reviewer. If it's unclear whether it ran, the investigator checks.
- 6
Las normas de la casaThe house rules
Un tope de gasto por ejecución, y normas escritas en código para lo que el formato no cubre, como no reembolsar más de 500 €.A spending cap per run, and rules written in code for what the format doesn't cover, such as never refunding more than 500 €.
Las normas de la casaHouse rules
Qué hace cumplir orq, y qué no puedeWhat orq enforces, and what it can't
Casi todo se impone por construcción. La única parte que depende del modelo está a la vista y se mide.Almost everything is enforced by construction. The one part that depends on the model is in plain sight and gets measured.
Un agente solo habla con quien permiten sus conexiones.An agent only talks to the participants its links allow.
Cada agente solo recibe las herramientas de comunicación de sus conexiones.An agent only gets the communication tools of its own links.
Cada mensaje tiene la forma declarada.Every message has the declared shape.
Se valida contra su esquema antes de entregarlo. Si se rechaza, se le explica al agente para que lo corrija.It is validated against its schema before delivery. A rejected message is explained to the agent, which can fix it.
Un agente solo usa sus herramientas, y las escrituras pueden necesitar la aprobación de otro agente o de una persona.An agent only uses its own tools, and writes can need approval from another agent or a person.
orq apunta la intención antes de cada llamada, así que una escritura interrumpida se comprueba en vez de repetirse.orq records each call's intent first, so an interrupted write is checked instead of repeated.
Presupuesto, activaciones, pasos y plazos.Budget, activations, steps and deadlines.
Una ejecución que agota su presupuesto se pausa hasta que le des más.A run that spends its budget pauses until you give it more.
Cuándo está terminado el trabajo.When the work is done.
La condición de finalización, por ejemplo «una propuesta que el revisor aprobó, sin cambios desde entonces».The finish condition, for example “a proposal the reviewer approved, unchanged since”.
Cuándo interviene una persona.When a person takes part.
Solo donde la red lo declara: una aprobación, una pregunta o elegir entre versiones. Si no, la ejecución termina sola.Only where the network declares it: an approval, a question or a choice between versions. Otherwise the run ends on its own.
Lo que el agente debe y no debe hacer: su propósito.What the agent should and shouldn't do: its purpose.
El modelo, a través de sus instrucciones. Es lo único que no se puede imponer por construcción, y por eso se mide con evaluaciones.The model, through its instructions. It is the one part that can't be enforced by construction, so it is measured with evaluations.
ModelosModels
Cambia de modelo sin tocar las reglasChange the model without touching the rules
Quién ocupa cada despacho se decide en otro fichero, el entorno. Cada agente puede usar un modelo distinto, de cualquiera de los 41 proveedores disponibles, incluidos modelos locales, y no hay ningún proveedor por defecto. Cuando salga un modelo mejor, cambias una línea: las puertas, las firmas y el registro siguen igual.Who sits in each office is set in another file, the environment. Each agent can use a different model, from any of the 41 available providers, local models included, and there is no default provider. When a better model comes out, you change one line: the doors, the signatures and the log stay the same.
Las claves no se guardan nunca. El fichero solo nombra la variable de entorno que las contiene.Keys are never stored. The file only names the environment variable that holds them.
El libro de registroThe logbook
Cada ejecución queda escrita, paso a pasoEvery run is written down, step by step
orq añade cada evento de una ejecución a un registro que solo crece. Con ese libro puedes:orq appends every event of a run to a log that only grows. With that logbook you can:
orq inspectVer dónde estáSee where it stands
La línea de tiempo completa: qué recibió cada agente, qué hizo y cuánto costó.The full timeline: what each agent received, what it did and what it cost.
orq explainSaber por quéKnow why
Por qué una ejecución está como está, contado en frases.Why a run is as it is, told in plain sentences.
orq resumeSeguir donde se paróPick up where it stopped
Una ejecución detenida continúa sin repetir las llamadas que ya se hicieron.A stopped run continues without repeating the calls already made.
orq replayReproducirlaReplay it
Se vuelve a ejecutar sin llamar a ningún modelo, comprobando que salen los mismos eventos.It runs again without calling any model, checking that the same events come out.
Dónde encajaWhere it fits
¿Qué proceso de tu empresa tiene estas piezas?Which process in your company has these pieces?
orq encaja cuando varios pasos los pueden hacer agentes, alguno toca un sistema de verdad y alguien tiene que dar el visto bueno antes. Por ejemplo:orq fits when agents can do several of the steps, some of them touch a real system, and someone has to sign off first. For example:
Reclamaciones y devolucionesClaims and returns
Investigar el caso, aplicar la política y no devolver dinero sin una firma.Investigate the case, apply the policy and never refund without a signature.
Compras y gastosPurchasing and expenses
Contrastar cada solicitud con el presupuesto y la política antes de comprometer dinero.Check each request against the budget and the policy before committing money.
Alta de proveedoresSupplier onboarding
Reunir y verificar documentos de varias fuentes, y dar el alta solo con aprobación.Gather and verify documents from several sources, and onboard only with approval.
Tickets de soporte (AMS)Support tickets (AMS)
Clasificar cada ticket, buscar casos parecidos ya resueltos y proponer la solución. Los cambios en el sistema, solo con la firma de un técnico.Classify each ticket, look up similar solved cases and propose the fix. Changes to the system only with a technician's signature.
Revisión de contratosContract review
Comparar cláusulas con tus políticas y llevar a una persona solo lo que la necesita.Compare clauses with your policies and bring to a person only what needs one.
Informes con fuentesSourced reports
Investigar en paralelo y no publicar ninguna cifra que no esté respaldada.Research in parallel and publish no figure that isn't backed by a source.
Mantenimiento de plantaPlant maintenance
Leer los sensores, diagnosticar la avería y preparar la orden de trabajo. Parar una línea, solo con la firma del jefe de turno.Read the sensors, diagnose the fault and prepare the work order. Stopping a line only with the shift lead's signature.
Corrección de exámenesExam grading
Dos correctores independientes, un tercero que arbitra si no coinciden, y la nota final la firma el profesor.Two independent graders, a third that arbitrates when they disagree, and the teacher signs the final grade.
Publicaciones de marcaBrand publishing
Redactar, revisar el tono y los datos, y no publicar nada en la web ni en redes sin el visto bueno.Draft, check the tone and the facts, and publish nothing on the web or social media without sign-off.
Cómo se trabajaHow you work with it
Del proceso contado con palabras a una red que funcionaFrom a process told in plain words to a working network
Se lo describes a tu agente de programaciónYou describe it to your coding agent
Cuentas el proceso a Claude Code o Codex con tus palabras, y escribe la red y sus pruebas.You tell Claude Code or Codex the process in your own words, and it writes the network and its tests.
La pruebas sin gastarYou test it for free
Con agentes simulados, cada prueba recorre la red entera sin llamar a ningún modelo.With simulated agents, each test runs through the whole network without calling any model.
La usan otros agentesOther agents use it
orq ofrece cada red como una herramienta más para Claude Code, Codex o cualquier cliente MCP.orq offers each network as one more tool for Claude Code, Codex or any MCP client.
EstadoStatus
Lo que ya funciona y lo que vieneWhat works today and what comes next
Ya funcionaWorks today
- El núcleo: conexiones, mensajes tipados, aprobaciones, límites, registro, reanudación y reproducciónThe core: links, typed messages, approvals, limits, log, resume and replay
- Modelos reales de 41 proveedoresReal models from 41 providers
- Herramientas y conocimiento desde servidores MCPTools and knowledge from MCP servers
- Cada red, como herramienta para otros agentesEvery network as a tool for other agents
- Un editor visual para diseñar y probar redesA visual editor to design and test networks
- Una primera versión de producción, revisada enteraA first production version, fully reviewed
Lo siguienteNext
- Conectores con los sistemas de cada empresaConnectors to each company's systems
- Pilotos en procesos reales de clientesPilots on real client processes
Quién lo haceWho builds it
Juancho Prego Gundín
Diseño y construyo sistemas de agentes de IA para procesos de empresa que tocan sistemas de verdad. orq es mi propio entorno de ejecución: lo he diseñado y construido, y es la base de los sistemas de agentes que hago.I design and build AI agent systems for business processes that touch real systems. orq is my own runtime: I designed and built it, and it is the base of the agent systems I make.
¿Tienes un proceso en mente? Escríbeme y vemos juntos cómo quedaría como red de agentes.Have a process in mind? Get in touch and we'll look at how it would work as an agent network.
HablemosLet's talk
- CorreoEmail
- contact@juancho.dev
- Web
- juancho.dev