用途：面向 .NET 开发者，指导使用 Microsoft.Agents.*、Microsoft.Extensions.AI、AIAgent、HarnessAgent、AgentSession 及 Agent Framework 托管包构建、评审 AI 智能体与多智能体工作流，并在多种智能体类型、工作流、托管方案间做出取舍。
主要能力与决策要点：区分确定性代码、单一 AIAgent/ChatClientAgent、打包长任务运行时的 HarnessAgent、类型化 Workflow、workflow.AsAIAgent() 包装、声明式 YAML 工作流、Azure Functions 持久智能体和 ASP.NET Core 托管智能体。会话状态由 AgentSession 持有，智能体应保持基本无状态，会话须通过所属智能体序列化与恢复，不能把原始服务会话 ID 当作终端用户授权边界。工具层建议收窄范围，副作用工具需审批；MCP、A2A 与第三方服务视为信任边界。工作流应显式建模执行器、边、类型化 RequestPort、检查点、共享状态与人机协同。新远程集成优先 Responses 协议；仅确需 Azure Functions 无服务器托管、持久线程存储或确定性长时编排时使用持久智能体。
使用方式：按资料提供的路径创建智能体，如 chatClient.AsAIAgent(...)、chatClient.AsHarnessAgent(...)、AnthropicClient.AsAIAgent(...) 或 AnthropicFoundryClient.AsAIAgent(...)；工作流执行使用 InProcessExecution.RunStreamingAsync(...)；敏感工具用 ApprovalRequiredAIFunction 包装并监听 RequestInfoEvent 与 ToolApprovalRequestContent；AG-UI 托管当前使用 Microsoft.Agents.AI.Hosting.AGUI.AspNetCore 的 AddAGUIServer() 与 MapAGUIServer(...)。
适用场景：聊天助手、长时自主任务、类型化多步编排、YAML 可移植编排、智能体间 A2A 互操作、AG-UI 远程 UI、本地 DevUI 调试、从 Semantic Kernel 或 AutoGen 迁移。
限制：需注意预览状态、包成熟度与提供方差异；Harness 的文件、Shell、Web 搜索、常驻审批与后台智能体能力应逐项限定并注意其文件/Shell 边界不是安全沙箱；DevUI 仅用于开发调试；Python 专属文档不代表 .NET 具备等价 API；语义细节以官方文档快照为准。