プロシージャ

概要

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

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

プロシージャの種類

プロシージャには2種類あります。

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

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

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

プロシージャを使用するタイミング

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

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

プロシージャを管理する

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

制限事項

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