代理概念

代理框架代理結合代理抽象、模型或遠端代理連線、指令、工具、中介軟體、情境提供者及會話狀態,置於一致的執行介面之下。

執行時間與執行方式

  • Running Agents 解釋了定期與串流的運行、運行選項、回應、訊息與內容。
  • 代理管線 說明中介軟體、上下文提供者、模型調用及工具如何參與執行。

代理人類型

  • 自訂代理 說明了常見代理介面及何時直接實作代理。
  • 模型提供者 將應用擁有的代理連接到推論服務。
  • 代理服務 連接至受管理或協定支援的遠端代理。

聊天客戶端代理

聊天客戶端代理是由模型推論客戶端支持的應用擁有代理。 它們支援功能工具、多回合對話、提供者託管的工具(如有)、結構化輸出、串流、中介軟體,以及本地或服務管理的對話歷史。

任何實 Microsoft.Extensions.AI.IChatClient 作 的推論用戶端都可以支持一個 ChatClientAgent

using Microsoft.Agents.AI;

AIAgent agent = new ChatClientAgent(
    chatClient,
    instructions: "You are a helpful assistant.");

所有代理實作皆共享抽象 AIAgent ,因此應用程式程式碼與編排能透過同一介面與聊天客戶代理、自訂代理及遠端代理伺服器協同運作。

關於提供者功能、對話歷史支援及 SDK 端點選擇,請參見 模型提供者

從任何實SupportsChatGetResponse作以下內容的客戶端建立標準Agent

from agent_framework import Agent

agent = Agent(
    client=client,
    instructions="You are a helpful assistant.",
)

相同的 Agent 介面可在支援的模型供應商間運作。 直接代理類型 FoundryAgent如 、 A2AAgentGitHubCopilotAgent,並 ClaudeAgent 連接至受管理或遠端代理執行時。

關於可用的推論客戶端,請參見 模型提供者

Go 模型提供者套件透過提供者專屬的建構子建構 *agent.Agent 標準型別。 這讓應用程式程式碼擁有一致的執行、會話、工具、中介軟體及串流介面,而每個提供者則擁有用戶端初始化權限。

關於建構子與匯入路徑,請參見 模型提供者

對話與回憶

對話概念 涵蓋會話、上下文提供者、儲存、壓縮,以及內建的聊天歷史記憶提供者。

Middleware

中介軟體的概念 涵蓋定義、範圍、排序、共享狀態、執行時上下文、終止、錯誤及結果覆寫。

Safety

代理安全 描述了限制代理行為並降低操作風險的設計模式。 FIDES的安全執法仍屬於 代理能力

下一步