用途:Azure.AI.Agents.Persistent 是面向 .NET 的低层 SDK,用于创建和管理持久化 AI 智能体,围绕线程(Threads)、消息(Messages)、运行(Runs)与工具(Tools)组织工作流。
主要能力:客户端入口为 PersistentAgentsClient,包含 Administration、Threads、Messages、Runs、Files、VectorStores 等子客户端。支持的工具有代码解释器、文件检索、函数调用、Bing Grounding、Azure AI Search、OpenAPI、Azure Functions、MCP、SharePoint、Microsoft Fabric。可轮询或流式获取运行状态,流式更新类型包括 RunCreated、RunInProgress、RunCompleted、RunFailed、MessageContentUpdate、RunStepUpdate。
安装与认证:使用 dotnet add package Azure.AI.Agents.Persistent --prerelease 与 dotnet add package Azure.Identity 安装。需要环境变量 PROJECT_ENDPOINT、MODEL_DEPLOYMENT_NAME,以及按需使用的 AZURE_BING_CONNECTION_ID、AZURE_AI_SEARCH_CONNECTION_ID。通过 DefaultAzureCredential 认证。
使用方式:典型流程为创建 Agent、创建 Thread 与 Message、创建 Run 后轮询状态(建议间隔 500 毫秒),或在 RequiresAction 时提交 ToolOutput;也可用 CreateRunStreamingAsync 流式消费更新。文件检索需上传文件、创建向量存储并绑定 ToolResources;结束时删除线程、智能体、向量存储和文件。
限制:资料未提供收费与性能信息;需自行处理所有运行状态与异常(RequestFailedException),并仅在与描述范围匹配时使用,输出不能替代环境相关验证、测试或专家评审。