Microsoft Agent Framework Quick-Start ガイド

このガイドは、Agent Framework と Azure OpenAI を使用して、基本的なエージェントをすばやく起動して実行するのに役立ちます。

[前提条件]

開始する前に、次のことを確認してください。

• .NET 8.0 SDK 以降
• デプロイされたモデルを持つ Azure OpenAI リソース (たとえば、gpt-4o-mini)
• Azure CLI のインストール と 認証 (az login)
• ユーザーには、Azure OpenAI リソースの Cognitive Services OpenAI User ロールまたは Cognitive Services OpenAI Contributor ロールがあります。

注

Microsoft Agent Framework は、アクティブにサポートされているすべてのバージョンの .NET でサポートされています。 このサンプルでは、.NET 8 SDK 以降のバージョンをお勧めします。

注

このデモでは、認証に Azure CLI 資格情報を使用します。 az loginでログインし、Azure OpenAI リソースにアクセスできることを確認します。 詳細については、 Azure CLI のドキュメントを参照してください。 api キーがあり、ロール ベースの認証を使用しない場合は、 AzureCliCredential を ApiKeyCredential に置き換えることもできます。この場合、 az login は必要ありません。

プロジェクトを作成する

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

パッケージのインストール

パッケージは NuGet ギャラリーに発行されます |MicrosoftAgentFramework。

まず、次のコマンドを使用して、次の Microsoft Agent Framework NuGet パッケージをアプリケーションに追加します。

dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
dotnet add package Microsoft.Agents.AI.OpenAI --prerelease

基本的なエージェント サンプルの実行

このサンプルでは、Azure OpenAI チャット完了をバックエンドとして使用する、シンプルなAIエージェントの作成と利用方法を示します。 AzureOpenAIClientとカスタム命令を含むgpt-4o-miniを使用して、基本的なエージェントが作成されます。

サンプル コード

https://your-resource.openai.azure.com/は、必ず Azure OpenAI リソースのエンドポイントに置き換えてください。

using System;
using Azure.AI.OpenAI;
using Azure.Identity;
using Microsoft.Agents.AI;
using OpenAI;

AIAgent agent = new AzureOpenAIClient(
  new Uri("https://your-resource.openai.azure.com/"),
  new AzureCliCredential())
    .GetChatClient("gpt-4o-mini")
    .CreateAIAgent(instructions: "You are good at telling jokes.");

Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

(省略可能)Nightly パッケージをインストールする

最新の拡張機能または修正プログラムを含むパッケージを取得する必要がある場合は、 https://github.com/orgs/microsoft/packages?repo_name=agent-frameworkで Agent Framework の夜間ビルドを利用できます。

夜間ビルドをダウンロードするには、次の手順に従います。

1. これらの手順を完了するには、GitHub アカウントが必要です。

2. 次の手順を使用して、 read:packages スコープで GitHub 個人用アクセス トークンを作成 します。

3. アカウントが Microsoft 組織の一部である場合は、 Microsoft 組織をシングル サインオン組織として承認する必要があります。

   1. 先ほど作成した個人用アクセス トークンの横にある [SSO の構成] をクリックし、 Microsoftを承認します。

4. 次のコマンドを使用して、Microsoft GitHub Packages ソースを NuGet 構成に追加します。

   dotnet nuget add source --username GITHUBUSERNAME --password GITHUBPERSONALACCESSTOKEN --store-password-in-clear-text --name GitHubMicrosoft "https://nuget.pkg.github.com/microsoft/index.json"
   

5. または、 NuGet.Config ファイルを手動で作成することもできます。

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
     <packageSources>
       <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
       <add key="github" value="https://nuget.pkg.github.com/microsoft/index.json" />
     </packageSources>
   
     <packageSourceMapping>
       <packageSource key="nuget.org">
         <package pattern="*" />
       </packageSource>
       <packageSource key="github">
         <package pattern="*nightly"/>
         <package pattern="Microsoft.Agents.AI" />
       </packageSource>
     </packageSourceMapping>
   
     <packageSourceCredentials>
       <github>
           <add key="Username" value="<Your GitHub Id>" />
           <add key="ClearTextPassword" value="<Your Personal Access Token>" />
         </github>
     </packageSourceCredentials>
   </configuration>
   

   • このファイルをプロジェクト フォルダーに配置する場合は、Git (または使用するソース管理) で無視してください。
   • このファイルを格納する場所の詳細については、 nuget.config リファレンスを参照してください。

6. 夜間ビルドからプロジェクトにパッケージを追加できるようになりました。

   たとえば、次のコマンドを使用します。 dotnet add package Microsoft.Agents.AI --prerelease

7. また、最新のパッケージ リリースは、次のようにプロジェクトで参照できます。

   <PackageReference Include="Microsoft.Agents.AI" Version="*-*" />

詳細については、https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registryを参照してください。

[前提条件]

開始する前に、次のことを確認してください。

• Python 3.10 以降
• デプロイされたモデルを持つ Azure AI プロジェクト (たとえば、 gpt-4o-mini)
• Azure CLI のインストールと認証 (az login)
• Agent Framework パッケージをインストールします。

pip install -U agent-framework --pre

注

agent-frameworkをインストールすると、agent-framework-coreおよびその他のすべての公式パッケージがインストールされます。 Azure AI パッケージのみをインストールする場合は、pip install agent-framework-azure-ai --preすべての公式パッケージ (agent-framework-azure-aiへの依存関係agent-framework-core含む) を実行できます。そのため、ほとんどの場合、これを指定する必要はありません。 公式パッケージの完全な一覧は 、Agent Framework GitHub リポジトリにあります。

注

このサンプルでは、認証に Azure CLI 資格情報を使用します。 az loginでログインし、Azure AI プロジェクトにアクセスできることを確認します。 詳細については、 Azure CLI のドキュメントを参照してください。

基本的なエージェント サンプルの実行

このサンプルでは、Azure AI をバックエンドとして使用する単純な AI エージェントを作成して使用する方法を示します。 ChatAgentとカスタム命令を含むAzureAIAgentClientを使用して、基本的なエージェントが作成されます。

次の環境変数を設定してください。

• AZURE_AI_PROJECT_ENDPOINT: Azure AI プロジェクト エンドポイント
• AZURE_AI_MODEL_DEPLOYMENT_NAME: モデル展開の名前

サンプル コード

import asyncio
from agent_framework.azure import AzureAIClient
from azure.identity.aio import AzureCliCredential

async def main():
    async with (
        AzureCliCredential() as credential,
        AzureAIClient(async_credential=credential).create_agent(
            instructions="You are good at telling jokes."
        ) as agent,
    ):
        result = await agent.run("Tell me a joke about a pirate.")
        print(result.text)

if __name__ == "__main__":
    asyncio.run(main())

その他の例

詳細な例と高度なシナリオについては、 Azure AI の例を参照してください。

次のステップ

エージェントの作成と実行