步驟六：特工安全帶

執行框架 (harness) 將聊天用戶端與代理程式處理漫長、多步驟工作所需的基礎結構結合在一起 — 包含規劃/執行模式、用來擬定計劃的待辦事項清單、內容壓縮、檔案記憶、檔案存取，以及「不再詢問」的工具核准機制。 與其自己組裝這些元件，不如建立一個 Harness Agent，即可直接使用這些現成功能。

使用 AsHarnessAgent 擴充功能方法從任何 IChatClient 建立 Harness Agent。 因為執行框架會透過多個步驟以互動方式執行工作，所以通常會透過交談迴圈來驅動它：保留一個 AgentSession，讓執行框架的狀態 (計劃、待辦事項和歷程記錄) 能在多回合交談間持續保存，讀取使用者的下一個指令，並在代理程式產生輸出時以串流方式傳送。

using System;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

// chatClient is any IChatClient implementation (Foundry, Azure OpenAI, OpenAI, Anthropic, ...).
AIAgent agent = chatClient.AsHarnessAgent();

// A session carries the harness state (plan, todos, history) across turns.
AgentSession session = await agent.CreateSessionAsync();

Console.WriteLine("Harness agent ready. Type 'exit' to quit.");
while (true)
{
    Console.Write("> ");
    string? input = Console.ReadLine();
    if (string.IsNullOrWhiteSpace(input) || input.Equals("exit", StringComparison.OrdinalIgnoreCase))
    {
        break;
    }

    // Stream this turn's output as the harness plans and works through the request.
    await foreach (var update in agent.RunStreamingAsync(input, session))
    {
        Console.Write(update);
    }

    Console.WriteLine();
}

這個執行框架負責整個交談的規劃、待辦事項追蹤和歷程記錄的保存。 如需功能完整的主控台——包含工具核准提示訊息、待辦事項／模式顯示，以及斜線指令——請參閱 終端機 UX 範例。

Tip

完整可執行應用請參閱 .NET 線束範例。

完整範例建立 Microsoft Foundry 聊天客戶端，並以 create_harness_agent 包裝，並在兩個互動回合中重複使用同一個工作階段。 此測試框架會新增規劃、待辦事項追蹤和壓縮功能，而範例則會停用檔案記憶體和網頁搜尋，以保持聚焦。

import asyncio

from agent_framework import create_harness_agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential


async def main() -> None:
    agent = create_harness_agent(
        client=FoundryChatClient(
            project_endpoint="https://your-account.services.ai.azure.com/api/projects/your-project",
            model="gpt-6-luna",
            credential=AzureCliCredential(),
        ),
        agent_instructions="Help users plan and complete multi-step tasks.",
        disable_file_memory=True,
        disable_web_search=True,
    )
    session = agent.create_session()

    print(await agent.run("Plan a weekend trip to Seattle.", session=session))
    print(await agent.run("Turn that plan into a checklist.", session=session))


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

共用工作階段會在兩個呼叫之間保留測試框架狀態。 若想看功能完整的主控台——包含工具核准提示、to-do 與模式渲染，以及斜線指令——請參考 範例終端機使用者體驗。

Tip

請參閱 完整的入門範例。 如需更多模式，請參考 Python harness 範例。

備註

代理程式執行框架的 Go 支援即將推出。 最新狀態請參閱 Agent Framework Go 倉庫 。

下一步

步驟 7：託管您的代理程式

深入探討：

  • 上次更新時間：