Libros de jugadas

1. Lea el recurso de equipos cuando el contexto del espacio de trabajo sea importante.
2. Use epismo_playbook_resource_list cuando un tipo de recurso pueda acotar el espacio de descubrimiento.
3. Encuentre candidatos con epismo_playbook_search; pase resourceKind y resourceRef juntos para una lista filtrada por recursos, o use una consulta de texto en su lugar.
4. Lea la última definición con epismo_playbook_get, que también devuelve las sugerencias abiertas del playbook, las versiones recientes y los alias en la misma lectura (gratis para un playbook público, 1 crédito en los demás casos).
5. Fije el trabajo reproducible con epismo_playbook_version_get.
6. Valide la entrada y adapte los pasos al plan del tiempo de ejecución del agente.

Un paso no es una tarea. El agente podrá omitir, combinar o reordenar pasos. Las sugerencias de recursos son candidatos, no comandos de instalación; verifique el permiso, la confianza y las credenciales antes de su uso.

Use epismo_playbook_create, epismo_playbook_version_publish y las herramientas de borrador para crear y actualizar playbooks. epismo_playbook_access_get y epismo_playbook_access_set usan visibility y editores explícitos. Public solo concede lectura del contenido publicado; los editores pueden editar contenido. Los miembros pueden leer y editar playbooks propiedad de ese workspace. Cualquier miembro de un workspace puede crear un playbook propiedad de ese workspace, o usar epismo_playbook_owner_transfer para mover un playbook personal privado a él. Un playbook propiedad de un workspace solo puede moverse al Owner de ese workspace o al creador del playbook. Solo un administrador propietario puede archivar un playbook o una versión histórica con epismo_playbook_version_archive; la última versión no se puede archivar.

Una superficie de creación itera mediante un borrador en lugar de publicar cada intento: epismo_playbook_draft_save para guardar (con baseRevision, no una clave de idempotencia), epismo_playbook_draft_get para volver a leerlo y epismo_playbook_draft_publish o epismo_playbook_draft_discard para finalizar. Un borrador sigue el acceso de edición del playbook; los lectores públicos y los enlaces compartidos no pueden leerlo.