secuencias de comandos
Entrada JSON, paginación, reintentos y contrato de secuencias de comandos.
Usa --request para proporcionar todos los parámetros de la solicitud como JSON en línea, desde un archivo o mediante stdin. Las opciones explícitas prevalecen sobre los campos de ese JSON. En case start y case update, --input indica solo los valores de entrada del caso; el input_schema del playbook define su formato.
Al crear en un Espacio, incluido el predeterminado guardado, elija exactamente una opción: --private, --team-ids "$TEAM_ID" (IDs separados por comas o un array JSON) o --access con la configuración completa. En el JSON de --request son private, teamIds y access; no las combine. En el espacio personal pueden omitirse. El acceso de edición del Equipo cubre al creador sin añadir un permiso directo redundante.
epismo playbook create --request @playbook.json
epismo case record append <case-id> --request @record.json
epismo playbook suggestion create <playbook-id> --request - < suggestion.jsonEl éxito escribe JSON en stdout y sale de 0. El error escribe un error en forma de JSON en stderr y sale de un valor distinto de cero. La automatización debe inspeccionar el código de error y los campos reintentables. Mantenga estos valores predeterminados en CI; --diagnostic-format human es para uso en terminal.
Los comandos de lista y búsqueda usan --page-size y --cursor; use --all para seguir cada cursor devuelto o --limit para limitar resultados. Use --output jsonl para un resultado por línea. --output value --field checkout_url extrae un escalar; --jq integrado admite proyecciones como .playbooks[] | .id.
Los comandos de mutación generan un UUID de idempotencia cuando se omiten. Reutilice una clave solo para la solicitud incierta idéntica. Las actualizaciones de casos y tareas requieren la última versión de bloqueo; después de un conflicto, vuelva a leer el estado y reconsidere el cambio previsto. Use --dry-run antes de cambios importantes de archivo, eliminación, revocación, cierre o ACL.