# Orquestar (PoC) — Claude Code

Método de Botize — `claude_code.orchestrate` (acción).

Paso de orquestación iterativa. Llama a Claude Code con el schema de orquestador (done/message/next_agent/reason) y pausa la tarea hasta que llega la respuesta (o un stop manual). La delegación multi-agente aún no está implementada: cuando 'done' es false la tarea termina con un texto informativo.

Es una acción: ocurre como paso de una tarea. Se pueden encadenar varias.

## Campos que se configuran

Nombre interno del campo, tipo y valores admitidos. En estos campos se pueden insertar etiquetas `{{...}}` de pasos anteriores.

- `mb_switch` *(boolean)* — Reglas
- `session` *(string)* — Nombre de sesión
- `message` *(string)* — Mensaje inicial
- `task_ids` *(string)* — IDs de las tareas-agente disponibles
- `max_iterations` *(number)* — Máximo de iteraciones
- `mb_outputvars_switch` *(boolean)* — Personalizar etiquetas

Además admite grupos de campos repetibles, con estos prefijos: `mb_filters_*`. Son componentes compuestos (botones, filtros, teclados); el número final lo pone el usuario al añadirlos.

## Variables de salida

Datos que este paso deja disponibles. Se referencian en pasos posteriores con la etiqueta entre dobles llaves.

- `{{text}}` *(text)* — Mensaje final. Mensaje final producido por el orquestador. Presente cuando done=true o stopped=true.
- `{{cost_usd}}` *(text)* — Coste (USD). Coste de la última llamada a la API en dólares. ej: 0.0032
- `{{duration_ms}}` *(int)* — Duración (ms). Tiempo total de respuesta de la última llamada en milisegundos
- `{{session_id}}` *(text)* — ID de sesión. UUID interno de la sesión de Claude
- `{{job_id}}` *(text)* — ID del job. Identificador del job de la última llamada
- `{{ok}}` *(boolean)* — Éxito. true si la llamada tuvo éxito, false en caso contrario
- `{{done}}` *(boolean)* — Hecho. 'true' cuando el orquestador terminó. Siempre 'true' al llegar a este output (las delegaciones re-pausan la tarea en lugar de emitir outputs).
- `{{next_agent}}` *(text)* — Siguiente agente (última delegación). Vacío en este output. Solo aparece en la notificación Pushover antes de re-pausar.
- `{{payload_json}}` *(text)* — Payload JSON (última delegación). Vacío en este output. Solo aparece en la notificación Pushover antes de re-pausar.
- `{{reason}}` *(text)* — Razón. Razonamiento breve detrás de la última decisión del orquestador.
- `{{permission_denials}}` *(text)* — Permisos denegados. Array JSON con las herramientas que Claude intentó usar pero fueron bloqueadas. Vacío si no hubo ninguna.
- `{{stopped}}` *(boolean)* — Parado manualmente. 'true' cuando la orquestación terminó porque el usuario hizo clic en un enlace de parar.
- `{{iterations_done}}` *(int)* — Iteraciones realizadas. Número de iteraciones del callback completadas antes de terminar.

## Cuenta

Necesita una cuenta de Claude Code conectada en Botize: https://botize.com/es/app/claude_code/authenticate

## Esta app

Todos los disparadores y acciones de Claude Code: https://botize.com/es/app/claude_code.md

## Cómo montar esto

Un asistente de IA (Claude, ChatGPT, Cursor…) puede crear y editar estas tareas en la cuenta del usuario a través del conector MCP de Botize, incluido en todos los planes:

    https://webhook.botize.es/mcp

- Guía de conexión: https://botize.com/es/mcp
- Mapa para agentes: https://botize.com/llms.txt
- Cuenta nueva: https://botize.com/es/join (500 operaciones gratis, sin tarjeta)

---
Resumen legible por máquinas para asistentes de IA. Versión para personas: https://botize.com/es/method/claude_code/orchestrate