Herramientas

Empacar herramientas

Para paquetes grandes, lea primero los datos del esquema. Luego busque el stepIds o blockIds seleccionado.

{
	"reference": "@repo-onboarding"
}

La respuesta general incluye contentIndex.stepIds o contentIndex.blockIds. Utilice esos ID para recuperaciones selectivas.

{
	"reference": "@repo-onboarding",
	"blockIds": ["b001", "b003"]
}

Utilice full=true solo cuando el cliente necesite cada bloque o paso.

Configure shareUrl en true para crear o devolver un enlace para compartir a pedido:

{
	"reference": "@repo-onboarding",
	"shareUrl": true
}

La respuesta incluye shareUrl cuando la creación del vínculo se realiza correctamente. Las llamadas de creación y actualización no generan un enlace para compartir automáticamente. Solicitar uno no hace público un paquete privado.

Antes de pasar un paquete grande a un agente, utilice el esquema para limitar el contenido que realmente necesita.

Ejemplo de creación de paquete

{
	"type": "context",
	"scope": { "type": "projects", "ids": ["project-id"] },
	"title": "Team onboarding",
	"blocks": [
		{
			"title": "Where things live",
			"content": "Docs in Notion, code in GitHub, designs in Figma."
		}
	]
}

Para paquetes de flujo de trabajo, pase steps en lugar de blocks. Utilice dependsOn para expresar el flujo entre pasos. Los asignados a los pasos del flujo de trabajo deben ser human o un ID de agente.

Ejecutando un paquete de flujo de trabajo

epismo_pack_rate califica el resultado del uso de un paquete (outcome: success | failure). Un resultado por cuenta y paquete: repetir la calificación actualiza el resultado anterior (últimas victorias). Los resultados calificados alimentan los recuentos de éxito/fracaso del centro y la clasificación de tendencias.

epismo_pack_run expande un paquete de flujo de trabajo en una pista en una sola llamada: un objetivo raíz (el objetivo de la ejecución y el ancla de recuperación) más una tarea todo por paso. Los identificadores del paso dependsOn se resuelven para realizar un seguimiento de los UUID y cada seguimiento creado lleva una fuente workflow:<pack-id>.

{
	"reference": "@release-review",
	"title": "Ship CSV export",
	"assignees": ["human=<user-id>"],
	"context": ["@repo-conventions"],
	"scope": { "type": "projects", "ids": ["project-id"] }
}

title/content es el valor predeterminado del paquete cuando se omite. Los mapas assignees empaquetan tokens de cesionario como pares token=id: asigne human a una identificación de usuario; Los identificadores de agentes se resuelven tal cual. Los pasos human no asignados se dejan sin asignar y se informan en warnings. context registra paquetes de contexto como fuentes context: en el objetivo.

La respuesta incluye goal.id, la identificación de cada tarea con su origen stepId y un stepMap. Obtenga la ejecución completa más tarde con epismo_track_search filtrado por goalId.

Herramientas de seguimiento

Utilice epismo_track_apply cuando un agente cree varias tareas relacionadas.

{
	"scope": { "type": "projects", "ids": ["project-id"] },
	"upserts": [
		{
			"id": "t001",
			"title": "Review MCP docs",
			"task": { "status": "todo", "dueDate": "2026-06-05" }
		},
		{
			"id": "t002",
			"title": "Publish docs changes",
			"task": { "status": "todo", "dependsOn": ["t001"] }
		}
	]
}

Los ID que no son UUID, como t001, crean nuevas pistas. Dentro de la misma llamada epismo_track_apply, esas etiquetas se pueden usar en parentId, dependsOn y goalId; el servidor los resuelve en UUID generados.

Cuando un agente está explorando, primero limite las consultas y los filtros y luego obtenga detalles solo de los registros que importan.

Los estados de las tareas son backlog, todo, in_progress y done. Los estados de los objetivos son not_started, on_track, at_risk, postponed y completed.

epismo_track_review genera una revisión de solo lectura para una o más tareas/metas. Pase references y, opcionalmente, instruction. Lee pistas de destino, tareas/objetivos relacionados, registros y paquetes de origen, luego devuelve estadísticas más Markdown content generado. Las revisiones detalladas consumen créditos según el uso subyacente del token de IA. No crea ni actualiza paquetes ni crea sugerencias; Llame explícitamente al paquete o a las herramientas de sugerencias si desea actuar en función del resultado.

Herramientas de registro

epismo_log_create agrega un comentario o registro de actividad a una tarea u objetivo; pase reference como UUID o URL de seguimiento de destino. Utilice kind: "update" para registrar lo que hizo o encontró un agente, kind: "review" para un veredicto o resultado de revisión y kind: "comment" para discusión. metadata es un JSON estructurado opcional con un límite de 16 KB serializado y se puede pasar idempotencyKey para una creación segura para reintentos. Agregar un registro es gratuito, por lo que los agentes deben iniciar sesión libremente en lugar de guardarlo para un resumen final.

epismo_log_list devuelve los registros más nuevos primero de forma predeterminada. Pase reference (un UUID o URL de pista) para abarcar una pista; omítalo para obtener un feed de actividad en cada pista a la que la persona que llama puede acceder actualmente, opcionalmente restringido con authorId de cualquier manera; use esto para "qué ha estado sucediendo" o "qué ha escrito este usuario". Pase el nextCursor de la última respuesta como cursor con el mismo order para buscar la página siguiente; use order: "asc" para reproducción cronológica o para recuperar solo lo que se agregó después de un registro conocido. La transmisión entre pistas (cuando se omite reference) refleja una instantánea de ACL tomada cuando se escribió cada registro, no una nueva verificación en vivo de la ACL actual de la pista; un registro escrito mientras la persona que llama tenía acceso aún puede aparecer aquí después de que se revoque ese acceso, a diferencia de una lectura con alcance de reference, que siempre refleja la ACL en vivo de la pista. Un autor fuera de lo que la persona que llama puede ver (por ejemplo, alguien que ya se fue) regresa como "unknown" en lugar de una identificación de cuenta sin formato.

epismo_log_delete elimina un registro por ID de registro. Los autores pueden eliminar sus propios registros; El creador de una pista puede eliminar cualquier registro de esa pista. Los registros eliminados se omiten en los resultados de la lista futura.

Comportamiento crediticio

Los costos de las herramientas se enumeran en las tablas anteriores. Los créditos se consumen del contexto personal/del espacio de trabajo actual resuelto por el token OAuth. Si el contexto no tiene suficientes créditos, la llamada a la herramienta puede fallar con un error de crédito/pago.

Herramientas de alias

La entrada de alias es el nombre del alias; Se acepta y despoja de un @ líder. El formulario @handle/name hace referencia al alias de otra cuenta para su lectura y no se puede utilizar para crear ni eliminar uno.

epismo_alias_upsert toma un paquete reference (ID de paquete, alias, URL compartida o URL central) más el nombre del alias para crear. epismo_alias_upsert y epismo_alias_delete aceptan una namespace opcional: personal (predeterminada) o workspace (la cuenta compartida del espacio de trabajo activo, que cada miembro puede resolver). Sólo el propietario del paquete puede crear, redireccionar o eliminar un alias. epismo_alias_get resuelve una referencia de alias (@alias, alias o @handle/alias, con un namespace opcional para eliminar la ambigüedad) y devuelve el paquete id, type, namespace y un archivo listo para usar. reference; epismo_alias_list devuelve los mismos campos para cada entrada.

Herramientas de sugerencia

Las sugerencias son propuestas de mejora basadas en texto para flujos de trabajo y paquetes de contexto. epismo_suggestion_create toma un paquete reference, title y content y captura una instantánea del paquete en el momento del envío. epismo_suggestion_list selecciona la vista con owner: true (su bandeja de entrada), reference (un paquete) o ninguna (sugerencias que usted envió) y acepta statuses, page y includeSnapshots. Devuelve el content de cada sugerencia como una vista previa truncada; utilice epismo_suggestion_get para ver el contenido completo. Sólo el autor puede actualizar una sugerencia; solo el propietario del paquete puede resolverlo (open, applied, declined o archived). Consulte Sugerencias para ver el modelo completo.