コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

Microsoft Agent Framework の宣言型エージェントをインポートする — エージェントと MCP サーバー

Microsoft Agent Framework の宣言型エージェント — OpenAI モデル上で動作し、MCP サーバーを通じてドキュメントを検索する 1 つのエージェント — を、aggrega import で Aggrega ファイルに下書きし、アプリケーションのイメージを回答ファイルで一度だけ指定して、Docker Compose 向けにビルドしたものです。

Microsoft Agent Framework の宣言型エージェントをインポートする では、コマンド、それが尋ねる内容、書き出すファイルと各行がある理由、ビルド、そして実行中のエージェントまでを順を追って説明します。このフォルダーには、そのウォークスルーの各段階が収められています:

フォルダーまたはファイル内容
source/宣言型エージェント support-agent.yaml、フォルダーをワークスペースにする .aggrega-config.yaml、そして宣言型エージェントが持たない値を記した import-answers.yaml:アプリケーションのイメージと、Kubernetes 向けのビルドが OpenAI キーを読み取る Kubernetes Secret の名前
draft/aggrega import support-agent.yaml --target compose が書き出したファイル(変更なし、release.lock を含む)と、出力した内容:標準出力は stdout.txt、標準エラーは import.txt

宣言型エージェントはこの例のために書かれたものです。それを読み込むアプリケーションのコードはこの例に含まれません。インポートはそのコードを読むことはなく、アプリケーションが動作するイメージは Release が指定します。

ドキュメントリポジトリのチェックアウトでは、check.sh がインポートを再実行し、書き出した内容と出力した内容を draft/ と比較し、ウォークスルーが引用するブロックをこれらのファイルと比較して、インポートが書き出したものを検証しビルドします。このリポジトリの隣に標準ライブラリのカタログ(入手先)がチェックアウトされているか、そのディレクトリが AGGREGA_CATALOG_DIRS に指定されている必要があります。

サンプルを生成する

この例のインポートは、以下のコマンドで実行することも、AI アシスタントに代わりに実行させることもできます。

例の名前を付けた新しいフォルダーに例を書き出します。

Terminal window
aggrega scaffold --example import-agent-framework

その後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。

Terminal window
cd import-agent-framework

ビルド

インポートは、宣言型エージェントの隣の source/ に Aggrega ファイルを下書きします。プロジェクトは標準ライブラリのカタログと照らし合わせて評価されます。このカタログはワークスペースのデフォルトレジストリが署名付きスナップショットとして公開しており、最初のインポートがそれを取得して検証し、ワークスペースのコンテンツキャッシュに保持し、下書きの隣に書き出す記録の中でそのダイジェストによって指定します。独自のカタログフォルダーを指定するワークスペース — AGGREGA_CATALOG_DIRS で、または workspace.catalog_dirs の下で — は、代わりにそれらに対してインポートします。インポートは import-answers.yaml からイメージを読み取り、次に下書きされた Release が依存するものをプルするため、すぐにビルドを続けられます:

Terminal window
cd source
aggrega import support-agent.yaml --target compose
aggrega build --release release.yaml

例で指定しているイメージは、プロジェクトからビルドするイメージを表しています。そのビルド方法とスタックの実行方法は、上記リンク先のウォークスルーにあります。

AI アシスタントを使う

Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。

Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `import-agent-framework` フォルダーがない場合は、`example` を `import-agent-framework` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、例が新しい `import-agent-framework` フォルダーに書き込まれ、その `source` フォルダーにこの例がインポートするものが入ります。次に、`workspace_root` を `import-agent-framework/source`、`source` を `support-agent.yaml`、`target` を `compose` に設定して `import` ツールを呼び出してください。このツールは、必要な回答を `support-agent.yaml` の隣にある `import-answers.yaml` から読み取り、ドラフトを `import-agent-framework/source` に書き込み、ドラフトに必要なものをプルします。次に、`workspace_root` を `import-agent-framework/source`、`release` を `release.yaml` に設定して `validate` ツールを呼び出し、`workspace_root` を `import-agent-framework/source`、`release` を `release.yaml`、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。ファイルは `import-agent-framework/source/dist/` の下にあります。

テストする

ウォークスルーと同じ方法でスタックを実行すると、1 つのリクエストがエージェントに届きます。以下のルートはウォークスルー自身のプログラムのもので、ポート 8000 で動く小さな HTTP サーバーです。独自のプログラムでは、そのプログラムがルートを決めます。Release はエージェントを 127.0.0.1:8000 で公開するため、リクエストは自分のマシンから送ります:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'
{"error": "the agent failed: ChatClientException: (\"<class 'agent_framework_openai._chat_client.OpenAIChatClient'> service failed to complete the prompt: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the same error repeated as the exception it wraps]"}

この実行のキーはプレースホルダーだったため、応答はそのキーに対する OpenAI の拒否です。Kubernetes では、Service を持たない Deployment にローカルポートをフォワードし、別のターミナルからそこへ同じリクエストを送信します:

Terminal window
kubectl port-forward deploy/supportagent 8000:8000
Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'

応答は同じです。