Azure.AI.Agents.Persistent (.NET)
使用 Azure AI SDK for .NET 构建持久化 AI 智能体
开发者需要将持久化 AI 智能体集成到 .NET 应用程序中，并正确管理线程和流式传输。本技能提供了完整的 SDK 模式，用于智能体 CRUD、对话流程、函数调用和使用 Azure AI Agents 进行文件搜索。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“Azure.AI.Agents.Persistent (.NET)”。 创建一个启用了代码解释器的数学辅导智能体
预期结果:
智能体创建成功，ID 为 'asst_abc123'。智能体配置了 gpt-4o-mini 模型和 CodeInterpreterTool。指令：'你是一位个人数学辅导老师。编写并运行代码来回答数学问题。' 已准备好创建线程和处理用户消息。
正在使用“Azure.AI.Agents.Persistent (.NET)”。 流式传输智能体对求解 3x + 11 = 14 的用户问题的响应
预期结果:
流式输出：'要解 3x + 11 = 14，我需要隔离 x。首先，两边减去 11：3x = 3。然后除以 3：x = 1。让我用代码验证一下。' 运行完成，最终答案显示 x 等于 1。
安全审计
安全Documentation-only skill with no executable code. Static analysis found 0 security issues with risk score 0/100. The SKILL.md file contains legitimate Azure SDK usage examples for agent creation, thread management, streaming, and function calling. No security concerns identified.
质量评分
你能构建什么
构建数学辅导智能体
创建一个使用代码解释器解决数学问题的持久化智能体。用户通过线程消息提交问题，智能体执行 Python 代码计算答案并提供逐步解释。
文档搜索助手
实现具有向量存储文件搜索功能的智能体，以回答上传文档中的问题。上传文件、创建向量存储，并通过自然语言对话进行查询。
使用函数调用的天气机器人
构建一个通过函数定义调用外部天气 API 的智能体。定义工具模式、处理 RequiresAction 响应，并向用户返回格式化的天气数据。
试试这些提示
使用 Azure.AI.Agents.Persistent SDK 创建持久化 AI 智能体。智能体应使用 gpt-4o-mini 模型，并带有充当有帮助的助手的指令。展示使用 DefaultAzureCredential 进行身份验证和基本智能体创建代码。
展示如何使用 CreateRunStreamingAsync 实时流式传输智能体响应。包括处理 MessageContentUpdate 和运行状态事件（如 RunCreated 和 RunCompleted）。
创建一个具有用于获取天气数据的自定义函数工具的智能体。使用 JSON 模式参数定义 FunctionToolDefinition，处理 RequiresAction 状态，并将工具输出提交回运行。
为智能体设置文件搜索功能。上传文档文件，使用文件 ID 创建向量存储，配置 FileSearchToolResource，并创建一个可以搜索文档来回答问题的智能体。
最佳实践
- 始终使用 'using' 语句或显式处理来释放客户端资源
- 轮询智能体运行时，状态检查之间延迟 500ms 以避免速率限制
- 完成后删除线程、智能体和向量存储以清理资源
避免
- 调用智能体 API 时不要跳过 RequestFailedException 的错误处理
- 避免在应用程序代码中直接硬编码凭据或端点 URL
- 避免在没有延迟的情况下进行紧密轮询，这可能会触发速率限制