Microsoft Foundry エージェント拡張機能の概要

Azure Developer CLI (azd) 用 Microsoft Foundry エージェント拡張機能を使用すると、ターミナルまたはエディターから Microsoft Foundry にエージェントのひな形を生成し、プロビジョニングして、デプロイできます。 Foundry エージェントの機能と azd ライフサイクル コマンドを組み合わせて、一貫性のあるローカルからクラウドへのワークフローを実現します。 いくつかのコマンドを使用して、サンプル エージェントからデプロイされた呼び出し可能なエンドポイントに移動できます。

この記事では、拡張機能について説明します。 詳細な手順については、foundry ホスト型エージェントのMicrosoftドキュメントを参照してください。

主な機能

特徴 Description
プロジェクトスキャフォールディング コード テンプレートとしてのインフラストラクチャ、エージェント定義、構成など、完全なエージェント プロジェクトを設定して、すぐに反復処理を開始できるようにします。
宣言型の構成 一貫性のある環境のために、 azure.yaml ファイル内のサービス、リソース、モデルのデプロイを定義します。
統合されたプロビジョニングとデプロイ コンテナーの構築、イメージのプッシュ、リソースの作成、モデルのデプロイ、エージェントの発行を行う azd up を 1 つの手順で実行します。
エージェント定義の管理 カタログ、GitHub、またはローカル パスからエージェント定義をインポートし、必要なパラメーターを環境変数にマップします。
デフォルトで安全が確保されています 資格情報を手動で処理せずに、マネージド ID とベースライン セキュリティを自動的に設定します。
スケーラブルなモデルのプロビジョニング モデル名、バージョン、容量を指定し、環境間で一貫してデプロイします。

ワークフローを調べる

この拡張機能は、スキャフォールディングからライブ エージェントまでの使い慣れた azd ライフサイクルに従います。

  1. スキャフォールディング: コードとしてのインフラストラクチャ、エージェント定義、構成など、サンプル エージェント プロジェクトを初期化します。
  2. プロビジョニングとデプロイ: Foundry アカウントとプロジェクトを作成し、モデルをデプロイし、エージェント コンテナーをビルドしてプッシュし、エージェントを発行します。
  3. ローカルで実行する: リモート Azure リソースに接続しながら、ローカル コンピューター上のエージェントを反復処理します。
  4. 呼び出しと監視: デプロイされたエージェントにプロンプトを送信し、ライブ ログをストリーミングします。
  5. 破棄: 完了したら、プロビジョニングされたすべてのリソースを削除します。

試してみる

最小限のワークフローでサンプル エージェントをデプロイしてみてください。 この例では、Microsoft Foundry ドキュメントの基本的な Agent Framework サンプルを使用します。

  1. 空のフォルダーにサンプル エージェント プロジェクトをスキャフォールディングします。

    azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yaml

  2. リソースをプロビジョニングし、1 つの手順でエージェントをデプロイします。

    azd up

    Tip

    また、この手順を azd provision と azd deploy に分けて、各段階をより細かく制御することもできます。

  3. 完了したら、プロビジョニングされたすべてのリソースを削除します。

    azd down

    Warnung

    azd down は、リソース グループ内のすべてのリソースを完全に削除します。 共有環境または運用環境では注意して使用してください。

前提条件、モデルの選択、ローカル テスト、トラブルシューティングについては、「 クイック スタート: 最初のホステッド エージェントをデプロイする」を参照してください。

エージェント拡張機能を使用するタイミング

Microsoft Foundry では、Python SDK、Visual Studio Code、ポータルなど、ホストされるエージェントを構築してデプロイするいくつかの方法がサポートされています。 azd エージェント拡張機能は、次の場合に最適です。

  • 主にターミナルまたはエディターから 、スクリプト可能で反復可能なワークフローを使用して作業します。
  • ソース管理下の宣言型のファイルとBicep ファイルを使用して、azure.yamlします。
  • 他のAzure アプリに既に使用しているのと同じ ライフサイクル コマンド (azd、azd init、azd up) を使用して、azd downします。
  • 環境 (開発、テスト、運用) 全体のデプロイを標準化し、CI/CD で自動化します。

ガイド付きポータル エクスペリエンスを使用する場合や、Python SDK を使用してエージェントを作成する場合は、代わりに foundry でホストされるエージェントMicrosoftドキュメントから始めます。

その他のリソース

  • Last updated on