チュートリアル: Microsoft Agent Framework または Foundry Agent Service (.NET) を使用して Azure App Service でエージェント Web アプリを構築する

AgentFrameworkProviderは Services/AgentFrameworkProvider.cs で初期化されます。 初期化コードでは、次の処理が行われます。

• Azure OpenAI からIChatClientを使用してAzureOpenAIClientを作成します。
• CRUD アプリケーションの機能をカプセル化する TaskCrudTool インスタンスを取得します ( Tools/TaskCrudTool.cs)。 ツール メソッドの Description 属性は、エージェントがそれらを呼び出す方法を決定するのに役立ちます。
• CreateAIAgent()によって登録された手順とツールを使用して、AIFunctionFactory.Create()を使用して AI エージェントを作成します。
• エージェントがナビゲーション全体で会話を保持するためのスレッドを作成します。

// Create IChatClient
IChatClient chatClient = new AzureOpenAIClient(
        new Uri(endpoint),
        new DefaultAzureCredential())
    .GetChatClient(deployment)
    .AsIChatClient();

// Get TaskCrudTool instance from service provider
var taskCrudTool = sp.GetRequiredService<TaskCrudTool>();

// Create agent with tools
var agent = chatClient.CreateAIAgent(
    instructions: @"You are an agent that manages tasks using CRUD operations. 
        Use the provided functions to create, read, update, and delete tasks. 
        Always call the appropriate function for any task management request.
        Don't try to handle any requests that are not related to task management.
        When handling requests, if you're missing any information, don't make it up but prompt the user for it instead.",
    tools:
    [
        AIFunctionFactory.Create(taskCrudTool.CreateTaskAsync),
        AIFunctionFactory.Create(taskCrudTool.ReadTasksAsync),
        AIFunctionFactory.Create(taskCrudTool.UpdateTaskAsync),
        AIFunctionFactory.Create(taskCrudTool.DeleteTaskAsync)
    ]);

// Create thread for this scoped instance (persists across navigation)
var thread = agent.GetNewThread();

return (agent, thread);

ユーザーがメッセージを送信するたびに、Blazor コンポーネント ( Components/Pages/AgentFrameworkAgent.razor) は、ユーザー入力とエージェント スレッドで Agent.RunAsync() を呼び出します。 エージェント スレッドはチャット履歴を追跡します。

var response = await this.Agent.RunAsync(sentInput, this.agentThread);

FoundryAgentProvider プロバイダーは Services/FoundryAgentProvider.cs で初期化されます。 初期化コードでは、次の処理が行われます。

• Foundry プロジェクト エンドポイントを使用して AIProjectClient を作成します。
• Microsoft Foundry から既存のエージェントを名前で取得します。
• ブラウザー セッションの会話を作成します。
• エージェントと会話の ProjectResponsesClient を取得します。

// Create project client
var projectClient = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential());

// Get an existing agent from Microsoft Foundry
var agent = projectClient.Agents.GetAgent(agentName);

// Get conversations client for retrieving history
var conversationsClient = projectClient.OpenAI.Conversations;

// Create conversation for this browser session
var conversation = conversationsClient.CreateProjectConversation().Value;

// Get response client for this agent and conversation
var responseClient = projectClient.OpenAI.GetProjectResponsesClientForAgent(agentName, conversation.Id);

return (responseClient, conversation, conversationsClient);

この初期化コードでは、通常は Foundry ポータルでエージェントをビルドするため、エージェントの機能は定義されません。 シナリオ例の一部として、「 Foundry Agent Service (.NET) で App Service アプリをツールとして追加する」に示されている OpenAPI パターンに従い、その CRUD 機能を OpenAPI エンドポイントとして使用できるようにします。 これにより、後で呼び出し可能なツールとしてエージェントに追加できます。

OpenAPI コードは 、Program.csで定義されています。 たとえば、"タスクの取得" API は、Microsoft Foundry の OpenAPI 仕様ツールで必要に応じて WithName()を使用して操作 ID を定義し、WithDescription()はエージェントが API を呼び出す方法を決定するのに役立ちます。

app.MapOpenApi();

app.MapGet("/api/tasks", async (TaskService taskService) =>
{
    return Results.Ok(await taskService.GetAllTasksAsync());
})
.WithDescription("Gets all tasks.")
.WithName("GetAllTasks");

ユーザーがメッセージを送信するたびに、Blazor コンポーネント ( Components/Pages/FoundryAgent.razor) はユーザー入力で ResponseClient.CreateResponseAsync() を呼び出します。 応答クライアントは、会話 ID を使用してチャット履歴を追跡します。

#pragma warning disable OPENAI001
var response = await FoundryProvider.ResponseClient.CreateResponseAsync(sentInput);
#pragma warning restore OPENAI001

1. Foundryポータルでプロジェクトを作成します。

2. 任意のモデルをデプロイします ( Microsoft Foundry クイック スタート: リソースの作成を参照)。

3. モデルプレイグラウンドの上部から、モデル名をコピーします。

4. ホームページでAzure OpenAIエンドポイントをコピーしておきましょう。

1. Foundryポータルでプロジェクトを作成します。

2. ホームページでProjectエンドポイントをコピーして後で使います。

3. 「 開始建設 」を選び、プロンプトに従ってください。

4. Tools>Add>Add tools>Custom>OpenAPI tool>Create を選択します。 [セットアップ] ウィンドウで、OpenAPI 仕様ツールを使用してアクションを追加します。

5. 認証済みのApp ServiceアプリからコピーしたOpenAPIスキーマを貼り付けます。

6. [認証方法] で、[マネージド ID] を選択します。

7. Audienceについては、AZD出力からFoundry OpenAPI管理型アイデンティティのオーディエンス値を貼り付けます。 その外観は以下の通りです:

   api://<generated-client-id>
   

8. ツールとエージェントは節約しましょう。

親FoundryリソースがタスクAPIを呼び出すことを許可します

1. Foundryポータルの上部メニューで 「管理 」を選択してください。

2. Projectの詳細で、projectの親リソースを選択し、「Open in Azure portal」を選択します。

3. システムに割り当てられたアイデンティティの オブジェクト(プリンシパル)IDをコピーします。 そのIDをMicrosoft Entra IDで見つけ、そのApplication IDをコピーします。 詳細な手順については、「 親Foundryリソース識別子を探す」をご覧ください。

4. Codespace端末でアプリケーションIDをAZD環境に保存し、App Service認証設定を更新します:

   azd env set AZURE_AI_FOUNDRY_ACCOUNT_CLIENT_ID <application-id>
   azd provision
   

1. Foundryポータルの上部メニューで 「管理 」を選択してください。

2. Projectの詳細で、projectの親リソースを選択し、「Open in Azure portal」を選択します。

   Azureポータルからは、リソースにロールベースのアクセスを割り当てることができます。

3. App Serviceアプリのマネージデンティティと az loginで使用するユーザーの両方に、以下の役割を追加します。

   ターゲット リソース	必要なロール	次の場合に必要です
   鋳造所	Cognitive Services OpenAI ユーザー	Microsoft Agent Framework のチャット完了サービス。

   手順については、「Azure portal を使用して Azure ロールを割り当てる」を参照してください。

1. Foundryポータルの上部メニューで 「管理 」を選択してください。

2. Projectの詳細で「Azureポータルで開く」を選択します。

   Azureポータルから、プロジェクトにロールベースのアクセスを割り当てることができます。

3. App Serviceアプリのマネージデンティティと az loginで使用するユーザーの両方に、以下の役割を追加します。

   ターゲット リソース	必要なロール	次の場合に必要です
   Foundry プロジェクト	Foundry ユーザー	Foundry エージェントの読み取りと呼び出し。

   手順については、「Azure portal を使用して Azure ロールを割り当てる」を参照してください。