ナビゲーションにスキップ

手順

関連する場合にエージェントが読み込む、タスク固有の指示

概要

手順には、特定の1つのタスクに対する指示を含めます。各手順には、適用されるタイミングを説明するトリガーと、実行内容を説明するコンテンツがあります。会話がトリガーに一致すると、エージェントは手順を読み込みます。

エージェントが多くの異なるタスクを処理する必要がある場合は、手順を使用します。たとえばカスタマーサポートエージェントでは、返金、本人確認、アカウント復旧、接続トラブルシューティングなど、リクエストの種類ごとに手順を作成できます。

エージェントダッシュボードの
手順タブ

手順の種類

手順には2種類あります。

  • 自由形式の手順 は、エージェントが解釈し、状況に合わせて調整する自然言語の指示です。
  • 構造化された手順 は、エージェントが毎回同じ方法で実行する、型付きステップの順序付きリストです。

同じエージェントで両方の種類を使用できます。種類にかかわらず、エージェントはトリガーに基づいて関連する手順を選択します。

手順は互いに呼び出せます。自由形式の手順はインライン 参照で別の手順を呼び出し、 構造化された手順はサブ手順 ステップで別の構造化された手順を呼び出します。よくあるパターンとして、自由形式の手順で柔軟な対応を行い、毎回同じ方法で実行する必要がある部分を構造化された手順に引き渡します。

エージェントには、手順、ワークフロー、またはその両方を設定できます。両方を設定した場合、すべての手順をワークフロー内のすべての地点から利用できます。手順を特定のワークフローノードに限定することはできません。多くのエージェントはどちらか一方のアプローチを中心に構築されますが、両者は組み合わせて使用できます。

手順を使用するタイミング

すべてのエージェントにはシステムプロンプトがあります。手順とワークフローは、その上に構造を追加する2つの方法であり、エージェントは両方を使用できます。会話の変動幅に応じて、開始点を選んでください。

要件使用するもの理由
シンプルな概念実証エージェントシステムプロンプトのみセットアップと反復が最も速い方法です。ただし、エージェントの対象範囲が広がるにつれて、1つのプロンプトは扱いにくくなります。
エージェントが表現や順序を調整できるタスク自由形式の手順会話全体を1つのLLMのコンテキストに保持するため、エージェントは表現や順序を調整し、予期しない展開にも対応できます。コンテキストウィンドウをより多く使用します。
毎回同じ方法でステップを実行する必要があるタスク構造化された手順設定した順序で、毎回同じ方法で各ステップを実行します。短いステップリストとして作成できます。
複雑な分岐やエッジケースを完全に制御する必要がある場合ワークフロー自分で設計・接続するサブエージェントのグラフとして実行され、分岐と各ステップで使用するモデルを完全に制御できます。

自由形式の手順がデフォルトの選択肢です。最もすばやく作成でき、ドキュメントのように読めるため、技術職以外のチームでも管理できます。また、会話が想定外の方向に進んだ場合でもエージェントは立て直せます。認証、エスカレーション、金融取引のように、ステップのスキップや順序変更のコストが高い場合は、構造化された手順を使用してください。どちらの手順タイプにもないルーティングロジックやステップごとのモデル制御が必要な場合は、ワークフローを使用してください。

手順を管理する

手順の作成にはダッシュボードの使用をおすすめします。手順をプログラムで管理したり、デプロイツールに統合したりするには、CLIまたはAPIを使用します。

ダッシュボードでエージェントを開き、手順 を選択します。 + を使用して、自由形式または構造化された手順を作成します。同じメニューから手順をフォルダにグループ化することもできます。 作成方法については、自由形式の手順 および 構造化された手順 を参照してください。

制限事項

  • 手順のコンテンツは50,000文字までです。
  • エージェントは、最も最近開始された5つの手順をコンテキスト内に保持します。1回の会話でそれ以上開始された場合、最も古い自由形式の手順のコンテンツ、インラインツール、ナレッジベースドキュメントがプロンプトから除外されます。手順の対象を絞り、同時にアクティブになる数を減らすためにサブ手順を使用してください。
  • 手順のタイプは、作成後に変更できません。自由形式と構造化の間で変換するには、新しい手順を作成し、その手順への参照を更新してください。
  • 手順は1つのエージェントに属します。エージェント間で共有したり、ワークスペースレベルのリソースとして保存したりすることはできません。
  • エージェントを複製すると、手順は共有されずコピーされます。コピーには新しい手順IDが付与されるため、複製したエージェント内の参照では新しいIDを使用する必要があります。
  • 手順を特定のワークフローノードに限定することはできません。エージェントに両方がある場合、すべての手順をすべてのノードから利用できます。
  • 構造化された手順からナレッジベースドキュメントを参照することはできません。