SuperAPI AI 工具集

deepgram-python-text-intelligence

编程与开发

查看项目

更新于 10-15 20:35

技能介绍

用途:该技能面向 Python 代码编写与评审,用 Deepgram Text Intelligence / Read(/v1/read)对已有文本(转录稿、文档、聊天记录、邮件)或托管纯文本 URL 做分析,属于一次性 REST 分析,不支持流式。如果来源是音频并希望叠加分析,应改用 deepgram-python-audio-intelligence。

主要能力:返回情感(分段与平均值)、摘要、主题检测、意图识别,并支持自定义主题/意图。

使用方式:客户端用 DeepgramClient() 初始化,认证头为 Authorization: Token <api_key>。核心调用如下(请求体用 request=,传 text 或 url 之一):

client.read.v1.text.analyze(request={"text": "..."}, language="en", sentiment=True, summarize=True, topics=True, intents=True)

异步用 AsyncDeepgramClient() 并 await client.read.v1.text.analyze(...)。结果可从 response.results.summary.text、sentiments.segments/average、topics.segments、intents.segments 及 response.metadata 读取。关键参数还包括 custom_topic/custom_topic_mode、custom_intent/custom_intent_mode、callback、callback_method、tag。

限制与注意:使用 Token 认证而非 Bearer;情感/摘要/主题/意图目前仅支持英语,且需提供 language;/v1/read 的 summarize 仅接受布尔值,不要传 "v2"(那是 Listen 的选项,SDK 类型更宽但不代表 Read 支持);请求体为 JSON request=,不同于以音频为 body 的 /v1/listen;自定义主题/意图需指定模式(extended 或 strict),否则会被忽略。仓库示例见 examples/40-text-intelligence.py,线测见 tests/wire/test_read_v1_text.py。跨语言产品知识可用 npx skills add deepgram/skills 安装。