1.5.6　ユーザープログラム呼び出し機能（02-40以降）

1

ツール上限

1つのカスタムエージェントに対して，最大10個まで連携可能です。上限超過時は警告メッセージを出力します。カスタムエージェントのノードプロンプトのパラメータTOOLSにて利用するツール名を指定し，複数定義します。

2

ユーザープログラムの実行

ユーザープログラムの実行要求とともに，実行引数を送信します。実行引数が送信されるまでの流れは以下の通りです。

1. カスタムエージェントは，ツールの説明と，その実行引数のJSONスキーマをLLMに送信します。

2. LLMは実行引数のJSONスキーマに従って実行引数を生成し，返却します。

3. カスタムエージェントは，返却された実行引数を付与してユーザープログラムの実行要求を送信します^※1。

4. ユーザープログラムは指定された実行引数で処理を行い，結果を返却します。

5. カスタムエージェントはツール実行結果としてユーザープログラムの実行結果を取得します。

3

ユーザープログラムの実行引数

実行引数のJSONスキーマはツールプロンプト定義ファイル（tools.ja.yml）に設定情報を記載して定義します。^※2

指定できる引数の数や型には制限があります。詳細は「6.1.3ツールプロンプト定義ファイル（tools.ja.yml）（02-40以降）」を参照してください。

想定のJSONスキーマが作成されているかは設定ファイル（ai_assistant.yml）の該当ツールのservice.langchain.tools[].aws_lambda_function.handle.logging_args_schemaにtrueを指定することで，ログから確認できます。

4

ユーザープログラムへの入力

LLMが作成した実行引数の情報は，シリアライズされたJSON文字列として送信します。送信されるJSONオブジェクトは，ユーザーが定義したJSONスキーマに準拠したオブジェクトです。ユーザープログラム内でどの型のオブジェクトとして利用できるかはユーザープログラムを実装するランタイムに依存します。

5

ユーザープログラムの戻り値

ユーザープログラム実行要求の応答（HTTPレスポンスのレスポンスボディ）をシリアライズされたJSON文字列として以下の処理を行い，解釈します。

• 応答をJSON文字列にデシリアライズ（文字コードはUTF-8）

• JSON文字列をpythonの次のdict型に変換

  {"content": [{"type": "text", "text": "任意の文字列"}]}

ユーザープログラムの戻り値は，上記の処理を経て{"content": [{"type": "text", "text": "任意の文字列"}]}と表される必要があり，この形式を満たさない場合，ユーザープログラム呼び出し機能は異常終了します。ユーザープログラム呼び出し機能は，処理結果として上記の"任意の文字列"に該当する値をLLMに返却します。ユーザープログラムの処理中にエラーが発生し，service.langchain.tools[].aws_lambda_function.handle. raise_function_processing_errorにfalseが設定されていた場合は，HTTPレスポンスボディに含まれる"errorMessage"フィールドの値をLLMに返却します。

本機能で受信できるサイズ（HTTPレスポンスヘッダのContent-Length）は80KBです。

6

ログ出力

ユーザープログラムの呼び出しに合わせて下記のログを出力します。

• ツールを利用可能なワークフローが呼び出されたとき，ツールに定義されたJSONスキーマを以下のメッセージIDのログに出力します。

  KNBD20037-I

• カスタムエージェントがツールを実行したとき，ツールの識別子を以下のメッセージIDのログに出力します。

  KNBD20036-I

• カスタムエージェントの処理が正常に終了したとき，実行したツールの情報を以下のメッセージIDのログに出力します。

  KNBD20003-I

これらのログに出力されるリクエストIDは，AWSによって発行されるリクエストの識別子です。

なお，ユーザープログラムの戻り値は，ユーザープログラム呼び出し機能では明示的にロギングされません。

オブジェクト

−

オブジェクトの配下には，オブジェクト以外のデータ型を指定できます。

配列

−

配列の要素に関しても，データ型(オブジェクト，数値，文字列)を定義できます。要素をEnumで指定することも可能です。

数値

○

整数または浮動小数点数

文字列

○

ブール値

−

null

−