Functions

コード化はエージェント ツールとして機能し、エージェントでカスタム Python コードを決定論的なプロセスベースのツールとして、オートメーションや API ワークフローと併せて実行できます。

コード化された関数ツールを使用すると、エージェントはカスタム Python コードをツールとして実行できます。関数には決定論的なロジック (データ変換、計算、外部システムへの呼び出しなど) がカプセル化されており、エージェントはこれを推論で要求したときにこのロジックを呼び出し、返された結果に基づいて推論を行います。

コード化された関数は、API ワークフロー、オートメーション、エージェント ツールなど、エージェントが利用可能な他のプロセスベースのツールと同様に動作します。エージェントが入力引数を関数に渡し、関数が Python コードを実行して、構造化された出力を受け取ります。

関数は Studio Web で作成します。関数の記述、パッケージ化、パブリッシュの詳細については、『 Functions ユーザー ガイド』をご覧ください。

エージェントでの関数の使用方法

ソリューションで関数が利用可能になると、その関数は Studio Web のエージェント定義の [ ツール ] セクションに選択可能なツールとして表示されます。各ツールには、エージェントがその目的と使用すべき状況を理解するのに役立つ説明が付いています。

実行時に、エージェントは入力パラメーターを関数に渡します。関数は Python ロジックを実行し、結果は計画の次のステップのための構造化された出力としてエージェントに返されます。ロジックは決定論的なコードであるため、関数は同じ入力に対して同じ出力を返すため、言語モデルが推論だけでは実行すべきではない正確な操作に適しています。

他の種類のツールと同様に、コード化された関数はプラットフォームのガバナンス制御をサポートします。関数をいつ、どのように呼び出すかを制御するための ガードレール を設定したり、実際のコードを実行せずにエージェントの推論をテストするための ツール シミュレーション を設定したりできます。

関数をツールとして追加する

利用可能なリソースから既存の関数を追加することも、エージェントを離れることなく新しい関数を作成することもできます。

1. [定義] パネルの [ツール] セクションで、[ツールを追加] を選択します。
2. [ 関数] を選択します。
3. 関数を追加します。
   • 既存の関数を使用するには、関数を検索するか、利用可能なリソースから選択します。
   • 新しい関数を作成するには、[ 新規作成] を選択します。関数作成ウィザードがソリューション内で開きます。
4. システム プロンプトを使用して、関数の目的と、エージェントがいつその関数を使用すべきかを説明します。すべての引数に対して、エージェントがそれらを効果的に使用するのに役立つ説明を入力します。

関数の実行の監視

エージェントがコード化された関数ツールを実行する場合、次の 2 つの場所で実行を検査できます。

• エージェントのトレース — デバッグの実行後、実行証跡に関数のツール呼び出しが含まれます。ここには、関数に渡された入力引数と返された出力が表示されます。
• Orchestrator — 関数はプロセスとして実行されます。Orchestrator の [ジョブ>監視 ] では、関数はエージェントの他のジョブ実行とともにジョブとして表示されます。