Перейти к содержимому
Moira Documentation

Playbooks

Playbook — именованный переиспользуемый текст поведения: стандарт ревью, тон, определение готовности. Он живёт в одном месте, а узел воркфлоу ссылается на него по имени, поэтому один текст служит нескольким воркфлоу и правится один раз. Правка playbook меняет то, как ведёт себя агент, не трогая того, что делает процесс.

Ссылка на playbook

Узел называет playbook как {{playbook:name}} — свой, или {{playbook:@owner/name}} — опубликованный playbook другого аккаунта. Ссылка работает везде, где обрабатывается шаблон: в директиве, условии завершения, материализуемом файле, дефолте переменной реестра, — и разрешается на каждом шаге, поэтому идущий процесс подхватывает правку на ближайшем шаге. Когда текст уместен в playbook, а когда в дефолте реестра, описано в Статической конфигурации workflow.

Определение со ссылкой на playbook, который вы не можете прочитать, отклоняется при редактировании, а запуск с такой ссылкой — до создания. Если playbook стал недоступен посреди запуска, шаг продолжается с видимым плейсхолдером, а на запуске остаётся запись о том, что он шёл без этого текста.

Веб-интерфейс

Playbooks управляются на странице Playbooks, доступной из боковой навигации:

  • Просмотр своих playbooks с заголовком, машинным именем, видимостью и превью текущего текста
  • Создание, правка и удаление; редактор показывает ссылку, которой воспользуется узел
  • История версий: каждое сохранение — ревизия; откройте историю, чтобы прочитать прошлую ревизию, увидеть её рядом с текущей или как построчное сравнение и восстановить — восстановление записывает новую ревизию с прежним текстом
  • Публикация: опубликованный playbook может читать и называть любой вошедший пользователь; менять его по-прежнему можете только вы
  • Если playbook читают идущие процессы, редактор говорит, сколько их, до сохранения: правка дойдёт до них на ближайшем шаге

На странице воркфлоу шаг, называющий playbooks, перечисляет их в своих деталях со ссылкой на каждый: свой открывается в редакторе, опубликованный playbook другого аккаунта — только для чтения на странице Playbooks; недоступный вам playbook помечен как недоступный. На странице запуска шаг, прошедший без playbook, показан на вкладке «Ошибки» под собственным заголовком, отдельно от ошибок: процесс продолжился, но без этого текста.

Инструмент MCP

Инструмент playbooks даёт агенту те же операции: список, чтение (в том числе прошлой ревизии или опубликованного playbook другого аккаунта), сохранение, удаление, история, сравнение, восстановление и видимость. См. Справочник инструментов MCP.

Связанное