用途：@azure/ai-projects 是面向 Azure AI Foundry 项目的 TypeScript 高层 SDK，用于在代码中管理智能体、连接、模型部署、数据集、搜索索引、评估指标与智能体记忆，并调用 OpenAI 兼容接口完成响应与对话。
安装：npm install @azure/ai-projects @azure/identity；如需追踪，另装 npm install @azure/monitor-opentelemetry @opentelemetry/api。需配置环境变量 AZURE_AI_PROJECT_ENDPOINT 与 MODEL_DEPLOYMENT_NAME，并使用 DefaultAzureCredential 等凭据初始化 AIProjectClient。
主要能力：client.agents 创建与管理智能体（支持 code_interpreter、file_search、web_search_preview、azure_ai_search、function、mcp 等工具）；client.connections 列出与获取连接及凭据；client.deployments 列出模型部署并按发布者过滤；client.datasets 上传文件或文件夹并管理版本；client.indexes 创建与管理搜索索引；client.evaluators 管理评估指标；client.memoryStores 管理智能体记忆。通过 getOpenAIClient() 可获得 OpenAI 客户端，用于 responses.create 与 conversations.create 等调用。
使用方式：先初始化客户端，再按需调用各操作组；运行智能体时先创建会话，再以 agent_reference 生成响应，完成后删除会话与智能体版本。建议对智能体使用 createVersion 保证可复现，从项目连接获取凭据而非硬编码，并用 modelPublisher 过滤部署。
适用场景：需要在 TypeScript 应用中集成 Azure AI Foundry 项目资源、构建带工具的智能体、管理数据集与索引、执行评估或调用 OpenAI 兼容接口的开发者。
限制：仅在任务与上述范围明确匹配时使用；输出不能替代针对具体环境的验证、测试或专家审查；若缺少必要输入、权限、安全边界或成功标准，应停止并请求澄清。具体收费与价格信息暂未提供。