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

Playbooks

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

Ссылка на playbook

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

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

Playbooks, которые поставляет Мойра

Мойра устанавливает несколько публичных playbooks от своего аккаунта moira и обновляет их с каждым выпуском, так же как встроенные флоу. Читать их может любой, а узел называет их вместе с владельцем, например {{playbook:@moira/clear-report}} — чеклист отчёта, на который ссылается пример 1, с русским двойником @moira/clear-report-ru. Без владельца то же имя означало бы ваш собственный playbook.

Эти playbooks принадлежат аккаунту Мойры moira: их можно читать и называть, но не менять. Выпуск, который меняет playbook, обновляет его на вашем сервере и сохраняет прежний текст в истории; запуск более старого выпуска никогда не откатывает его назад; а playbook, который выпуск больше не поставляет, остаётся на месте, чтобы ничего, что его называет, не перестало работать.

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

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

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

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

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

Инструмент MCP

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

Связанное