用途:为 Foundry Agent Service SDK 提供研究工作流,指导在实现智能体功能、查找 SDK 方法、获取代码样例或探索 API 时如何查证,而不是猜测 SDK 用法。
主要能力:
- 子代理委派研究:当需要跨 3 个以上仓库搜索、为找模式阅读 5 个以上文件、全面探索 API 面、查找某方法/类型的所有用法时,委派给子代理,并限定额外返回内容(最多 20 行),避免上下文膨胀。可内联的场景包括本地代码 grep、已知方法查找、单文件阅读、快速签名检查。
- SDK 架构说明:Foundry Agent Service SDK 有 v2 Agents API(端点 /agents/,可读 ID,经 AIProjectClient.AgentAdministrationClient)和 OpenAI Assistants API(端点 /assistants/,OpenAI 格式 ID,经 PersistentAgentsClient)两套接口。文中项目使用 v2 Agents API。
- 权威来源:Azure.AI.Projects SDK 仓库、Azure.AI.Agents.Persistent 样例、Microsoft Foundry Samples、Azure 架构中心样例、React UI 参考样例、Semantic Kernel、OpenAI .NET SDK、GitHub 代码搜索,以及官方文档链接。
- 迁移与反射:说明了 AIProjectClient 需项目端点 URI 而非连接字符串,并给出 PowerShell 反射加载 DLL 查类型/方法签名的做法。
使用方式:先按来源顺序检索(SDK 仓库→官方 quickstart→架构样例→UI 参考),或通过 runSubagent 派发研究任务并限定返回行数;文档滞后时用反射读取 NuGet 缓存中程序集。
限制与注意:Agent Framework 的 Microsoft.Agents.AI.AzureAI 未引用,rc5 与 Azure.AI.Projects 2.0.0 GA 不兼容,运行时会抛 TypeLoadException;容器文件下载 C# SDK 尚无类型化客户端,需直接调用 REST API。当前使用的 SDK 包版本需查看 WebApp.Api.csproj。