Docs de agentes

Agentes · trabajo de IA dentro de Musa

← Todos los módulos · Conecta tu agente →

Agentes · trabajo de IA dentro de Musa

Qué hay en el módulo

Flujos

Seguir una skill propia

1. list_skills() → mira mine. Si el pedido calza con una (su description dice cuándo usarla), get_skill({ name }).

2. Sigue los pasos en orden. Cada paso trae el cómo y, si aplica, la herramienta de Musa exacta (y sus parámetros en la nota). En cada decisión toma el camino que corresponda; un subproceso te manda a otra skill con get_skill y vuelves.

Crear o editar una skill propia (cuando la persona te describe su proceso)

1. Pregunta en qué espacio va y si la quiere privada o compartida con su equipo.

2. Arma el flujograma en Mermaid: ([Inicio]), [Paso], {¿Decisión?} con salidas -->|sí| / -->|no|, [[Subproceso]], ([Fin]). Por cada paso agrega %% @how ID: cómo se hace y, si usa Musa, %% @tool ID: herramienta y %% @toolnote ID: parámetros.

3. save_workspace_skill({ workspaceId, mermaid, meta: { name, when, goal, inputs, outputs, rules }, visibility }). Revisa issues: corrige los errores (herramienta inexistente, decisión con una sola salida, pasos sueltos) y vuelve a guardar hasta ready: true.

4. Para cambiarla: get_skill_flow({ name }) → edita el Mermaid → save_workspace_skill({ id, mermaid }). Para borrarla, con confirmación: delete_workspace_skill({ id }).

Antes de actuar en un espacio

1. list_governance({ workspaceId }) → políticas activas y acciones recientes. Si una política prohíbe lo que te piden, no lo hagas y explícalo.

2. Al terminar algo relevante (publicar, enviar, cambiar datos de clientes), regístralo: agent_activity_log({ workspaceId, agentName, action, verdict: "Permitido" | "Bloqueado" | "Pidió aprobación" }).

Agentes del espacio

Tomar trabajo del tablero (modo harness)

1. harness_get_context({ agentType, workspaceId }) → tu rol, reglas y contexto.

2. harness_list_features({ workspaceId, status }) → tareas disponibles.

3. harness_claim_feature({ taskId }) → la tomas (nadie más la toma).

4. harness_start_session({ taskId, role, agentName, plan }).

5. Trabaja con las skills de cada módulo. Escribe avances, decisiones y archivos en harness_log_entry({ sessionId, entryType, content }), no solo en el chat.

6. harness_submit_for_review({ sessionId, summary }).

7. Si estás bloqueado: harness_release_feature.

8. Registra tiempo y tokens: studio_log_agent_time({ taskId, agentRole, durationMs, tokensUsed, aiModel }).

Revisar el trabajo de otro agente

1. harness_get_entries({ sessionId }) → bitácora del implementador.

2. harness_evaluate_checkpoint por cada criterio (aprobado o no, con notas).

3. harness_complete_feature({ taskId, sessionId }) solo si todo pasa.

Atender encargos que esperan a tu IA

Usar herramientas de otros servicios conectados

Enseñarle a la persona

Lote de Musa (producción en bloque)

Diagnóstico

Herramientas

Skills propias

Agentes y gobernanza

Sesiones y tareas

Tiempo y costo

Encargos

Integraciones y enseñanza

Lote

Diagnóstico

Reglas

Ejemplos

Documentación de agentes de Musaworks · actualizado 2026-11-20