Azure Cosmos DB 专家参考

你在什么场景会卡住

Azure Cosmos DB 同时提供 NoSQL、MongoDB、Cassandra、Gremlin、PostgreSQL、DocumentDB 等多套 API，文档分散在 Microsoft Learn 上。排障时要在 429 RU 限流、分区键设计、CMK 加密、变更源与 Functions 触发器、各语言 SDK 超时之间来回切换；做架构时还要在一致性级别、多区域、向量搜索与成本之间做取舍。单靠记忆很难覆盖全栈。

技能如何组织答案

本技能把分类索引当作入口：问题排查、最佳实践、决策制定、架构与设计模式、限制与配额、安全性、配置、集成与编码模式、部署。Agent 按主题定位到 SKILL.md 中的行号区间（如问题排查 L37–L91），或读取 integrations.md、deployment.md 等关联文件。

需要最新官方说明时，通过 网络拉取 Learn 文档：优先 mcp_microsoftdocs:microsoft_docs_fetch，查询串带 from=learn-agent-skill；备用 fetch_webpage 并请求 Markdown。本地索引列出各 API 的诊断 KQL、RU 监控、SDK 排障链路与 Bicep/Terraform 部署等链接，便于按错误码或工作负载类型跳转。

使用边界

• 依赖 Microsoft Learn 可访问；mcp_microsoftdocs 不可用时需自行安装或走备用抓取。
• 若 metadata.generated_at 超过约 3 个月，索引与链接可能滞后，建议从仓库更新技能包。
• 技能提供专家级指导与文档路由，不替代在订阅内直接改账户配置或跑生产变更。