add-agent-playbooks

エージェントのプレイブックを追加する

既存の Python エージェントで、Playbook に基づくターンを 1 回、動作確認まで行ってから、依頼されたコンテンツの移行または統合を完了します。FAQ には公開済みの回答を登録し、スキルには手順を登録します。スキルは検出時のプレビューとは別に読み込みます。応答ポリシー、ツールの権限、アクションの承認はアプリケーションが管理します。

1. 現状を把握して動作を選択する

モデル呼び出し、ツールの登録、フレームワークとバージョン、既存のポリシーまたは手順の情報源を特定します。グラフ、業務用ツール、全体的な応答ルールと認可ルールは維持します。依頼とコードから次の判断を行い、未解決の選択肢についてのみ質問し、使用するデフォルトを明示します。

判断事項	結果
どの反復タスクに手順が必要ですか？	手順ごとにスキルを 1 つ作成します。該当する手順がなければ省略します。タスク固有のツール使用ガイドはプロンプトから移します。
どの質問に承認済みの回答が必要ですか？	承認済みの回答ごとに FAQ を 1 つ作成します。該当する回答がなければ省略します。
コンテンツを利用するのはどの対象者ですか？	対象者が 1 つの場合、属性やフィルターは不要です。複数の場合は、コンテンツに対応する属性を設定し、信頼できる実行時の対象者情報を指定します。
回答できない質問を審査用に提出しますか？	デフォルトでは提出しません。提出する場合は、回答できない質問の自動提案にするか、アプリケーション側で品質とプライバシーのゲートを設けるかを選択します。既存のゲートは維持します。
現在、コンテンツはどこにありますか？	関連するプロンプトのテキスト、ドキュメント、または取得したコンテンツをバージョン管理されたファイルに変換します。正式な情報源は維持します。

エージェントがツールを実行できる場合は、段階的な情報開示を優先します。それ以外の場合は、スコアベースのフックを使用します。確認、エスカレーション、障害発生時の動作を定義します。承認済みの回答のみを返す場合は、コンテンツが不十分なときの明示的なポリシーが必要です。

2. 前提条件を確認して接続する

簡単な前提条件の確認と、新規、部分的、既存のセットアップについては、プロビジョニングに従います。利用可能な設定と公開済みコンテンツは再利用します。ローカルのデフォルト設定では、稼働中のスタックが必要です。Cloud とセルフマネージドの管理方法は異なります。

編集前に、インストール済みバージョンのフレームワーク API を確認します。利用可能なドキュメント MCP を使用します。CLI では、iris agent-playbooks <command> --help を実行します。ドキュメントとインストール済み API が一致しない場合は、インストール済みパッケージのソースコードを確認します。未解決の互換性に関する疑問は報告します。

3. 関連するコンテンツを最初に公開する

ファイル形式、品質チェック、対象者属性、検証、プレビュー、公開については、コンテンツの作成に従います。依頼されたタスクに関連する承認済み FAQ または手順を 1 つ用意します。両方が必要な場合にのみ、両方を用意します。エージェントを接続する前に、提供に使われるバージョンを確認します。最初のターンが動作した後、依頼された広範な移行を完了します。

4. アプリケーションに統合する

選択したモード、非同期のバリエーション、フレームワーク内での配置については、ランタイム統合に従います。設定済みのコンテキストオブジェクトを 1 つ作成し、全体で使用します。各ターンで、ベースプロンプトからコンテキストを新たに構築します。情報開示ツールは、モデルと実行側の両方に登録します。

5. 実行して、調査し、改善する

最初の成功に従って、実際のアプリケーションを実行し、コンテンツのキーとバージョン、手順の読み込みを確認します。言い換えた質問と、コンテンツがない場合の動作を確認し、見つかった問題を修正して再実行します。正常に動作した内容と再現方法をユーザーに示します。置き換え後の読み込みが動作したら、不要になったランタイムのプロンプト、リトリーバー、キャッシュのコードと、未使用の埋め込みパイプラインを削除します。最終的な統合に関連するアプリケーションのチェックを実行します。

6. 引き継いで保守する

最初の成功に記載された引き継ぎ方法を使用し、確認済みの結果と未検証の作業を区別して、正確な再実行コマンドを残します。次回の承認済みコンテンツ更新の手順を説明し、コンテンツの担当者と公開者、残っているデプロイ設定を明示します。

必須の制約と任意の選択肢

• すべての iris コマンドで、ルートオプション --json --no-input を使用します。CLI は管理とコンテンツ管理を担当し、Python SDK はアプリケーション内で実行します。
• ランタイム用の .env 認証情報は、.env.content の公開用認証情報および管理トークンと分けてください。エージェントには read を付与し、提出する場合に限り propose も追加します。シークレットを表示したり、env ファイルをコミットしたりしないでください。
• 公開によって、提供されるコンテンツが選択されます。プロポーザルはレビュー候補です。プロポーザルを提出または承認しても、自動的に公開されるわけではありません。
• セマンティックレスポンスキャッシュを使用する場合は、検索／書き込み経路を置き換える前に キャッシュの移行 を読んでください。
• Agent Memory からバックグラウンドでプロポーザルを作成する場合は、別の提出経路を有効にする前に Memory の抽出 を読んでください。