プレイブック
MCP からプレイブックを発見し、runtime へ適用する流れです。
- 必要なら teams resource を読み、現在の workspace context を確認する。
- resource kind で候補を絞れる場合は epismo_playbook_resource_list を使う。
- epismo_playbook_searchで目的に合う候補を探す。resource で絞る場合は
resourceKindとresourceRefを一緒に渡し、text query とは組み合わせない。 - epismo_playbook_getで latest Definition を読む。同じ読み取りで、そのプレイブックの未解決の提案、最近の Version、エイリアスも返る(公開プレイブックなら無料、それ以外は 1 credit)。
- 再現性が必要ならepismo_playbook_version_getで Version を固定する。
- input schema を検証し、Step を agent runtime の計画へ取り込む。
Step はタスクではありません。agent は状況に応じて省略、統合、並べ替えできます。resource hint は自動 install 命令ではなく、permission、trust、credential を確認してから使う候補です。
epismo_playbook_create、epismo_playbook_version_publish、下書き tool でプレイブックを作成・更新します。epismo_playbook_access_get と epismo_playbook_access_set は visibility と明示的な editor を扱います。公開設定では公開済み content の read だけを許可し、editor は content を edit できます。プレイブックと過去 Version の archive は owner manager のみが行え、latest Version は archive できません。
authoring surface では、試行のたびに publish するのではなく下書きで反復します。保存は epismo_playbook_draft_save(idempotency key ではなく baseRevision を使う)、読み出しは epismo_playbook_draft_get、仕上げは epismo_playbook_draft_publish または epismo_playbook_draft_discard です。下書きはプレイブックの edit access に従い、公開の reader と share link は読めません。