Pro-code エージェントを公開して呼び出す

すべての pro-code エージェントは、オントロジーのバインディングとエージェントAPI名を指定して公開されます。公開すると、追加の設定なしで、Workshop とオントロジー SDK の両方からエージェントの関数を呼び出せます。

オントロジーのバインディング

オントロジーのバインディングは、pro-code エージェントを特定のオントロジーに関連付けます。このバインディングによって、エージェントがスコープ付き権限を通じてアクセスできるオントロジーリソースが決まります。

すべての pro-code エージェントをオントロジーにバインドするため、エージェントの設定ページには必須のオントロジーセレクターがあります。公開する前に、エージェントが読み取りと書き込みを行うオントロジーを選択してください。

エージェントAPI名

各 pro-code エージェントは、Workshop またはオントロジー SDK から呼び出す際にエージェントの関数を識別するエージェントAPI名を指定して公開されます。エージェントAPI名はリポジトリ名から生成され、エージェントの設定ページのエージェントAPI名項目で編集できます。

Pro-code エージェントを公開する

エージェントを公開すると、Foundry はそのオントロジーのバインディングとエージェントAPI名を使ってエージェントを登録し、関数として公開します。公開後は、エージェントを呼び出すために追加の設定を行う必要はありません。

Pro-code エージェントをトリガーする

エージェントの関数は非同期で実行され、同期関数の実行時間の上限である5分の制限は適用されません。

Automate からエージェントをトリガーする（推奨）

Automate からエージェントをトリガーすることを推奨します。エージェントの関数を指定する関数の効果を使って自動化を設定します。エージェントは、自動化をトリガーしたユーザー、または自動化の実行に使用されるサービスユーザーとして実行されます。

Workshop、オントロジー SDK、またはオントロジーアクションからエージェントをトリガーする

Workshop、オントロジー SDK、オントロジーアクションなど、非同期関数を呼び出せる場所であれば、エージェントの関数を呼び出すこともできます。

エージェントの関数を直接呼び出す場合は、次の点に注意してください。

• 関数は値を返しません： エージェントの関数は Void を返すため、クエリ関数として呼び出すことはできません。Workshop、オントロジー SDK、またはオントロジーアクションから呼び出すには、関数の効果として呼び出すか、エージェントを呼び出す TypeScript のオントロジー編集関数でラップします。
• オントロジーを通じて結果を利用します： 関数は値を返さないため、エージェントが文字起こしの内容や結果をオントロジーのオブジェクトに書き込み、そのオブジェクトを読み取って出力を利用するようにします。このパターンは、AIP Evals でエージェントの出力を採点する場合にも適用されます。
• ストリーミング呼び出しとバッチ呼び出しには対応していません。

Pro-code エージェントに引数を渡す

Pro-code エージェントは、agent/index.ts の AgentArguments スキーマで定義された引数を受け取ります。

Pro-code エージェントをトリガーする際は、AgentArguments スキーマに一致するキーを持つ JSON オブジェクトを指定します。オントロジーのオブジェクトについては、オブジェクト全体ではなく主キーの値を渡し、エージェント内でオントロジー SDK または Ontology MCP を通じてオブジェクトを再取得します。

開発中に pro-code エージェントをローカルで実行するには、テンプレートの start コマンドで、インラインの JSON には --json-args、JSON ファイルには --json-args-file を使って引数を指定します。

Copied!
1
npm run start -- --json-args '{ "additionalAgentContext": { "type": "string", "string": "some context" } }'

次のステップ

• Foundry で最初の pro-code エージェントを作成して公開する。