技能 azure-ai-projects-ts
📦

azure-ai-projects-ts

安全

使用 Azure AI Projects SDK 构建 AI 应用

Azure AI Projects SDK 简化了使用代理、连接和评估构建 AI 应用的过程。本技能提供 Azure AI Foundry 开发的全面 TypeScript 示例。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“azure-ai-projects-ts”。 Create a basic agent with custom instructions for customer support

预期结果:

  • Agent created successfully: customer-support-agent v1.0
  • Model: gpt-4o
  • Tools: None
  • Status: Ready for deployment

正在使用“azure-ai-projects-ts”。 List available model deployments filtered by OpenAI publisher

预期结果:

  • gpt-4o - OpenAI - Status: Deployed
  • gpt-4-turbo - OpenAI - Status: Deployed
  • text-embedding-3-large - OpenAI - Status: Deployed

安全审计

安全
v1 • 2/24/2026

Static analyzer produced false positives by misinterpreting markdown code block delimiters (```) as shell commands. The file contains only documentation and code examples for the official Azure AI Projects SDK. URLs are placeholder examples with template values. Environment variable access follows standard best practices. No executable code or security risks present.

1
已扫描文件
295
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

企业级 AI 代理开发

构建具有代码解释器、文件搜索和网络搜索功能的生产就绪 AI 代理,用于企业工作流。

RAG 应用设置

为检索增强生成配置 Azure AI Search 索引和代理,使用自定义文档集合。

AI 评估管道

设置评估器和数据集,以跨不同指标衡量和改进 AI 模型性能。

试试这些提示

基础代理创建
使用 Azure AI Projects SDK 创建一个基础的 AI 代理,用于回复用户的问题并提供有帮助的答案。包含适当的身份验证和错误处理。
带文件搜索的代理
构建一个可以使用 Azure AI Search 搜索上传文档的 AI 代理。包括创建索引、上传文件和配置代理使用文件搜索工具的步骤。
多工具代理设置
创建一个结合代码解释器、文件搜索和自定义函数工具的 AI 代理。展示如何处理工具执行和响应聚合。
评估管道配置
使用 Azure AI 评估器设置完整的评估管道。包括数据集上传、指标配置和用于衡量代理性能的结果分析。

最佳实践

  • 使用 getOpenAIClient() 方法进行聊天补全、对话和文件操作
  • 使用 createVersion 对代理进行版本控制,以实现可重现和可追踪的部署
  • 不再需要时删除代理和对话以清理资源
  • 将凭据存储在环境变量中,并使用连接进行安全访问
  • 按 modelPublisher 筛选部署以高效查找特定模型类型

避免

  • 硬编码凭据而不是使用环境变量或连接
  • 创建代理时不进行版本控制,使回滚和追踪变得困难
  • 使用后保持对话和代理版本处于活动状态,导致成本累积
  • 跳过网络操作和 API 调用的错误处理

常见问题

使用此 SDK 需要哪些 Azure 资源?
您需要 Azure AI Foundry 中的 Azure AI 项目。这需要 Azure 订阅和您所在区域的 Azure AI 服务访问权限。
Azure AI Projects 的身份验证如何工作?
使用 DefaultAzureCredential 进行自动身份验证。它支持 Azure CLI、托管标识和服务主体。设置 AZURE_AI_PROJECT_ENDPOINT 环境变量。
我可以在没有 Azure 订阅的情况下使用此技能吗?
不可以。Azure AI Projects SDK 需要有效的 Azure 订阅和 Azure AI 项目。免费层选项可能可用于测试。
代理和 OpenAI 客户端有什么区别?
代理提供具有内置工具和内存的高级抽象。OpenAI 客户端直接访问聊天补全和低级 API 功能。
如何向代理添加自定义工具?
使用名称、描述和 JSON schema 参数定义函数工具。在使用工具数组创建代理版本时注册它们。
此技能可以在我的系统上执行代码吗?
不可以。此技能仅提供文档和代码示例。代码解释器工具在 Azure 的沙盒环境中运行,而不是在您的本地系统上。

开发者详情

文件结构

📄 SKILL.md