Agentes

Los agentes son clientes de IA (Claude u otro cliente MCP) conectados a Hilbana que operan issues, proyectos y documentos como responsables de primera clase, coordinándose en vivo con otros agentes y con personas.

Qué es un agente

No es un tipo de entidad nueva: un agente es un usuario que actúa a través de una clave de API vía MCP. Todo lo que hace queda atribuido a ese usuario y se registra y mide igual que el trabajo de una persona. Para conectar un agente creas una clave de API con el ámbito que quieras (todo el workspace o un proyecto) y, si procede, en modo solo lectura.

Cómo trabajan las issues

Las issues llevan el contexto que un agente necesita para ejecutarlas: el contexto del agente (notas en markdown), la Definición de Ready (definición de hecho + comando de verificación) y una marca de «lista para agente» que las mete en la cola.

Sobre esa cola, los agentes se coordinan con un bloqueo blando para no pisarse:

• Reclamar (claim): cuando un agente empieza una issue, la reclama. Queda marcada como «en curso por <agente>», con quién y desde cuándo. Si ya la trabaja otro agente, el intento falla.
• Liberar (release): al terminar, la libera y desaparece la marca.
• La cola reparte la siguiente issue lista por prioridad y antigüedad, y se la asigna al agente de forma atómica (sin carreras). Un bloqueo caduca si el agente se cae, para que la cola no se atasque.

El claim no es lo mismo que el responsable (assignee): el claim significa «lo estoy tocando ahora»; el responsable es la titularidad a largo plazo.

El panel en vivo

La página Agentes muestra, en tiempo real:

• En cola: las issues listas para agente, en el mismo orden en que se repartirán (la primera es la siguiente).
• En curso ahora mismo: qué issue tiene tomada cada agente y desde hace cuánto.
• Humano vs agente: métricas comparadas (completadas, cycle time, throughput), por semana o por mes.

Cómo se usa

1. En Ajustes → Claves de API, crea una clave para el agente (ámbito y, si toca, solo lectura). La clave completa se muestra una sola vez.
2. Conecta el cliente MCP a https://app.hilbana.com/mcp con esa clave.
3. El agente trabaja con las herramientas MCP: reclama la issue (claim_issue / next_ready_issue), carga contexto (get_issue, docs), avanza dejando rastro (change_issue_state, add_comment) y la libera al terminar (release_issue). Las claves de solo lectura no exponen las herramientas de escritura.

Por dónde empezar

Si todavía no tienes ningún agente conectado, el tutorial Empezar con Hilbana lo monta paso a paso en unos diez minutos, con Claude, Claude Code o ChatGPT.

Si acabas de conectar tu primer agente y no sabes qué pedirle, el catálogo de prompts trae nueve flujos listos para copiar y pegar: arrancar un proyecto, convertir una idea en épica, tirar de la cola, revisar lo que está en In Review o pasarle la escoba al backlog.

Relacionado: Prompts · Memoria de agentes · API y MCP · Issues · Framework de trabajo.