Azure 对话语言理解 Python 技能
帮助 Python 开发者使用 Azure SDK 分析对话意图和实体。
内容推荐DefaultAzureCredential、环境变量和禁用日志，并提供旧版密钥用法，显示了基本的权限与凭据安全意识；但未充分说明对话文本发送至Azure的 data flow、敏感信息处理、最小权限、用户确认或失败后的回滚，因此扣8分。
核心调用路径和同步/异步模式均有示例，且包含异常处理要求、重试和超时参考；但主示例疑似缺少代码围栏结束标记，未提供安装依赖、版本核验或可诊断异常示例，静态证据不足，因此扣12分。
目标用户、SDK、ConversationAnalysisClient及CLU场景描述清楚，也覆盖实体、编排和异步请求；但非适用边界、触发条件、中文示例和中国大陆网络环境说明不足，因此扣6分。
SKILL.md具有元数据、分层章节和参考文件，MIT许可、作者及版本也有记录；但缺少明确安装步骤、SDK版本号、变更日志、维护责任/更新路径、FAQ和已知限制，且示例格式疑似不完整，因此扣7分。
示例覆盖基本意图分析、实体置信度过滤、重试、编排和异步调用，能够支持核心编码任务；但缺少依赖安装、部署前置条件、完整输出验证和针对错误结果的处理，直接可用性仍需人工补充，因此扣9分。
文件提供了可审阅的代码、引用路径和仓库级CI/测试基础设施，具备有限可追溯性；但未见该技能专属测试套件、真实执行结果或第三方交叉验证，静态证据仅支持部分得分，因此扣6分。
- 主示例疑似缺少结束代码围栏，发布前应修复并验证示例可复制运行。
- 应明确披露对话文本的数据流、隐私/敏感信息处理、Azure区域与网络可达性，并补充中文输入示例。
- 应补充明确的SDK安装与版本策略、部署前置条件、异常响应示例和技能专属测试。
它能做什么 & 适用场景
该技能指导开发者使用 azure-ai-language-conversations Python SDK 实现对话式语言理解。它围绕 ConversationAnalysisClient、DefaultAzureCredential 和结构化对话请求负载展开。内容涵盖同步客户端生命周期、环境变量配置、异常处理建议以及旧有 API 密钥认证方式。适合需要将 Azure 对话分析集成到 Python 应用中的开发者。
指导创建 ConversationAnalysisClient，读取对话服务端点、项目名称和部署名称等环境变量，构造包含 participantId、id、语言、模态和文本的 ConversationAnalysisClient.analyze_conversation 请求，并处理返回的预测结果，例如输出最高意图。它还说明如何使用 DefaultAzureCredential、上下文管理器和旧有 AzureKeyCredential。
- Python 开发者需要根据用户消息识别对话意图和实体时使用。
- 构建 Azure AI Language 对话理解功能并需要示例请求负载的团队使用。
- 在本地开发和 Azure 部署之间切换，并希望使用 DefaultAzureCredential 保持认证方式一致的开发者使用。
- 需要在同步或异步 Python 调用路径中正确管理客户端和凭据生命周期的开发者使用。
优缺点一览
- 提供了可直接改写的 ConversationAnalysisClient 示例。
- 明确优先使用 DefaultAzureCredential，并覆盖本地开发和 Azure 环境。
- 强调客户端和异步凭据使用上下文管理器释放资源。
- 包含同步与异步使用原则以及旧有 API 密钥认证说明。
- 未提供 azure-ai-language-conversations 的具体最新版本号。
- 源材料未提供该技能独立的测试场景或测试覆盖证据。
- 引用的 references/capabilities.md 和 references/non-hero-scenarios.md 内容未包含在材料中。
- 需要已有 Azure 对话项目、部署和相应服务访问配置；源材料未说明成本或权限细节。
如何安装
在目标项目中运行 npx skills add microsoft/skills，然后在向导中选择所需技能。README 说明技能会安装到所选 Agent 的目录中；本技能的具体安装目标目录未单独说明。
如何使用
在已安装该技能的编码 Agent 中提出类似“请使用 azure-ai-language-conversations Python SDK 和 ConversationAnalysisClient 分析这段对话的意图与实体”的请求。根据技能指导配置 AZURE_CONVERSATIONS_ENDPOINT、AZURE_CONVERSATIONS_PROJECT 和 AZURE_CONVERSATIONS_DEPLOYMENT，使用 DefaultAzureCredential，并提交包含 conversationItem 的分析请求。