教學：使用 Microsoft Agent Framework 或 Foundry Agent Service （.NET） 在 Azure App 服務 中建立代理型網頁應用程式

AgentFrameworkProvider在Services/AgentFrameworkProvider.cs中初始化。 初始化程式代碼會執行下列動作：

• 使用 IChatClient 從 Azure OpenAI 建立 AzureOpenAIClient。
• 取得封裝 CRUD 應用程式功能的 TaskCrudTool 執行個體 (位於 Tools/TaskCrudTool.cs)。 Description工具方法上的屬性幫助代理人決定如何呼叫它們。
• 使用CreateAIAgent()創建 AI 代理，並通過AIFunctionFactory.Create()註冊指令和工具。
• 建立一個執行緒讓代理能在導航中持續對話。

// 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 取得現有的 Agent。
• 為瀏覽器會話創建對話。
• 為 Agent 與交談取得 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。 例如，「get tasks」API 以 WithName（） 定義操作 ID，這是 Microsoft Foundry 中 OpenAPI 規範工具的要求，並 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. 選擇 工具>新增>新增工具>自訂>OpenAPI 工具>建立。 在 [ 設定 ] 窗格中，使用 OpenAPI 規格工具新增動作。

5. 貼上你從已認證的 App Service 應用程式複製的 OpenAPI 架構。

6. 對於 認證方法，請選擇 管理身份。

7. 對於 Audience，將 AZD 輸出中的 Foundry OpenAPI 管理身份受眾 值貼上。 它類似：

   api://<generated-client-id>
   

8. 儲存工具和代理程式。

允許父系 Foundry 資源呼叫工作 API

1. 在 Foundry 入口網站中，請在頂方選單選擇 管理 。

2. 在 專案詳細資料 中，選取您的專案的 父資源，然後選取 在 Azure 入口網站中開啟。

3. 複製系統指派身份的 物件（主體）ID。 在 Microsoft Entra ID 中找到該身份，並複製其應用程式 ID。 詳細步驟請參閱 「尋找父 Foundry 資源識別碼」。

4. 在 Codespace 終端機中，將應用程式 ID 儲存在 AZD 環境中，並更新 App Service 認證設定：

   azd env set AZURE_AI_FOUNDRY_ACCOUNT_CLIENT_ID <application-id>
   azd provision
   

1. 在 Foundry 入口網站中，請在頂方選單選擇 管理 。

2. 在 專案詳細資料 中，選取您的專案的 父資源，然後選取 在 Azure 入口網站中開啟。

   從 Azure 入口網站，你可以為該資源指派基於角色的存取權限。

3. 為 App Service 應用程式的受控識別以及您搭配 az login 使用的使用者新增以下角色：

   目標資源	必要角色	所需
   鑄造廠	認知服務 OpenAI 使用者	Microsoft Agent Framework 中的聊天完成服務。

   若需指示，請參閱使用 Azure 入口網站指派 Azure 角色。

1. 在 Foundry 入口網站中，請在頂方選單選擇 管理 。

2. 在 Project 詳細資料中，選擇「在 Azure 門戶開啟」。

   你可以從 Azure 入口網站為專案指派基於角色的存取權限。

3. 為 App Service 應用程式的受控識別以及您搭配 az login 使用的使用者新增以下角色：

   目標資源	必要角色	所需
   鑄造廠計畫	Foundry 使用者	正在讀取與呼叫 Foundry 代理程式。

   若需指示，請參閱使用 Azure 入口網站指派 Azure 角色。

截圖顯示已部署的 Microsoft Agent Framework 成功管理 Web 應用程式中的任務。