SuperAPI AI 工具集

azure-ai-language-conversations-py

通用与其它

查看项目

更新于 10-16 07:13

技能介绍

用途:本技能用于借助 azure-ai-language-conversations Python SDK 实现对话语言理解(CLU)。当需要调用 ConversationAnalysisClient 分析对话意图与实体、构建 NLP 功能,或把语言理解集成进应用时使用。

主要能力:通过 analyze_conversation 提交 Conversation 任务,在 analysisInput.conversationItem 中提供 participantId、id、modality、language、text,并在 parameters 中指定 projectName、deploymentName、verbose,从返回结果读取预测的 topIntent 等信息。ConversationAnalysisClient 接受 TokenCredential(如 DefaultAzureCredential)。

认证与生命周期:优先使用 DefaultAzureCredential,本地(Azure CLI、VS Code、Developer CLI)与 Azure(托管标识、工作负载标识)均无需改代码;避免连接字符串与账户/API 密钥。仅当已有未迁移到 Entra ID 的密钥部署时使用 AzureKeyCredential。生产环境可设置 AZURE_TOKEN_CREDENTIALS=prod 或指定具体凭据以约束凭据链。客户端应使用上下文管理器:同步用 with ConversationAnalysisClient(...) as client:,异步用 async with ConversationAnalysisClient(...) as client:,异步 DefaultAzureCredential 来自 azure.identity.aio,也应使用 async with credential:。

最佳实践:同步与异步二选一并在同一调用路径保持一致,不要混用同步与 aio 客户端;用环境变量保存 endpoint、项目名与部署名;明确映射 conversationItem 中的 participantId 与 id。旧版示例:from azure.core.credentials import AzureKeyCredential; with ConversationAnalysisClient(endpoint, AzureKeyCredential(key)) as client:。

适用场景:对话意图与实体识别、NLP 功能开发、应用内语言理解集成。

限制:仅当任务与上游来源及本地项目上下文明确匹配时使用;应用前需自行验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代环境相关测试、安全审查,以及对破坏性或高成本操作的用户批准。SDK 最新版本、具体收费与定价、可用平台等信息暂未提供。