灵犀Note录音文件查询 Skill#

指令路由表#

指令角色说明详细文档/lyk list 或「录音列表」📋 列表官查询录音文件列表（默认销售录音）references/list.md/lyk meeting 或「会议录音」📋 会议官查询会议录音列表references/list.md/lyk detail 🎙️ 详情官查看指定ID录音的完整详情references/list.md/lyk config 或「配置灵犀」⚙️ 配置配置 API Keyreferences/config.md

---

自然语言路由#

text

「录音列表」「查录音」「销售录音」        → /lyk list
「会议录音」「会议列表」「查会议」         → /lyk meeting
「录音详情」「查看录音」                  → /lyk detail（需提供ID）
「配置」「连接灵犀」                       → /lyk config

决策原则：优先区分销售录音和会议录音。有"会议"关键字就是 /lyk meeting，其他默认 /lyk list。

---

API 路由表#

录音文件#

方法路径说明详细文档GET/api/api/apiKeyConfig/innerApi/userRecordingQuery销售录音列表查询references/list.mdGET/api/api/apiKeyConfig/innerApi/userRecordingMeetingQuery会议录音列表查询references/list.md

完整 URL 格式：LYK_API_URL（默认 https://aiapi.szyldata.com/api）+ 路径

⚠️ 路径为 /api/api/apiKeyConfig/innerApi/...（双 /api），最终拼接： https://aiapi.szyldata.com/api/api/apiKeyConfig/innerApi/...

---

⚠️ Agent 必读约束#

🔑 认证#

• 请求头： AuthorizationLyk: lyk-xxx（格式： lyk- 开头）
• 每次调用 API 前检查环境变量 LYK_API_KEY 是否存在；若不存在，提示用户先完成配置

🔢 请求参数规范（严格按文档）#

• 文档中未说明的参数，一律不传
• 销售录音列表接口 userRecordingQuery 为 无参 GET 请求
• 会议录音列表接口 userRecordingMeetingQuery 为 无参 GET 请求
• URL 拼接： LYK_API_URL + /api/api/apiKeyConfig/innerApi/...（双 /api）

🚫 反幻觉边界#

• 禁止编造录音 ID：所有 id 必须来自 API 响应，不得凭空构造
• 禁止伪造 API 响应：不得在未实际调用 API 的情况下告诉用户查询结果
• 禁止忽略错误码：API 返回非 200 时必须处理，不得静默吞掉

🔄 失败重试策略#

• 网络/服务错误（HTTP 5xx 或超时）：等待 5 秒后重试一次，仍失败则报告错误
• 鉴权失败（401）：检查 API Key 是否正确或已失效
• 服务错误（500）：稍后重试

🔒 安全规则#

• 录音数据属于用户隐私，不在群聊中主动展示完整内容
• 调用前验证 API Key 有效性

---

通用错误处理#

录音文件接口返回格式：

json

{
  "code": 200,
  "message": "操作成功",
  "msg": "操作成功",
  "data": [],
  "succeed": true
}

code说明处理方式200成功返回 data 数据401鉴权失败检查 API Key500服务错误稍后重试

常见错误码（500系列）#

错误消息说明处理方式AuthorizationLyk不能为空请求头中缺少 AuthorizationLyk 字段检查请求是否正确携带了 AuthorizationLyk: lyk-xxx 请求头AuthorizationLyk不存在提供的 API Key 无效或已失效确认 API Key 是否正确，或重新配置新的 Key

---

实现说明#

API 请求规范（严格遵循文档）#

1. 请求头：必须携带 AuthorizationLyk 字段，格式为 lyk-xxx
2. 请求参数：文档中未明确说明的参数，一律不传。两个列表接口均为 无参请求
3. URL 拼接：完整 URL = LYK_API_URL + /api/apiKeyConfig/innerApi/...（注意：只有 一个 /api）

请求示例#

销售录音（无参）：

bash

curl -X GET "https://aiapi.szyldata.com/api/api/apiKeyConfig/innerApi/userRecordingQuery" \
  -H "AuthorizationLyk: lyk-xxx" \
  -H "Accept: */*"

会议录音（无参）：

bash

curl -X GET "https://aiapi.szyldata.com/api/api/apiKeyConfig/innerApi/userRecordingMeetingQuery" \
  -H "AuthorizationLyk: lyk-xxx" \
  -H "Accept: */*"

Python 实现参考#

python

import requests

def list_recordings(api_key: str, api_url: str = "https://aiapi.szyldata.com"):
    """查询销售录音列表（无参）"""
    url = f"{api_url}/api/api/apiKeyConfig/innerApi/userRecordingQuery"
    headers = {"AuthorizationLyk": api_key, "Accept": "*/*"}
    resp = requests.get(url, headers=headers)
    return resp.json()

def list_meetings(api_key: str, api_url: str = "https://aiapi.szyldata.com"):
    """查询会议录音列表（无参）"""
    url = f"{api_url}/api/api/apiKeyConfig/innerApi/userRecordingMeetingQuery"
    headers = {"AuthorizationLyk": api_key, "Accept": "*/*"}
    resp = requests.get(url, headers=headers)
    return resp.json()

响应字段#

字段类型说明codeint状态码，200 为成功messagestring消息msgstring消息dataarray录音数据数组succeedboolean是否成功

data 数组元素（实际API返回字段）#

⚠️ 以下字段名称严格来自真实 API 响应，不得删除或修改。

字段类型说明idstring录音文件IDpublicUrlstring公网URL（音频文件地址）transcriptionSegmentsJsonstring带时间戳的录音分析分段（JSON字符串）summaryJsonstring全文摘要（JSON字符串），解析后含 title 和 summarykeyPointsJsonstring重点内容（JSON字符串）insightAnalysisJsonstring洞察分析（JSON字符串）mindMapJsonstring思维导图（JSON字符串）translationJsonstring翻译（可能为null）speakerSummaryJsonstring按说话人总结（JSON字符串）briefSummaryJsonstring极简总结（JSON字符串）meetingMinutesJsonstring会议纪要（可能为null）bantRawstringBANT销售分析（可能为null）competitorSwotRawstringSWOT分析（可能为null）actionItemsRawstring待办事项（JSON字符串）speakerNamesJsonstring说话人名称映射（可能为null）dialogExcerptsJsonstring对话节选（JSON字符串）highlightDialogueJsonstring高光对话（JSON字符串）speechDurationJsonstring说话人时长占比（JSON字符串）emotionCurveJsonstring客户情绪曲线（JSON字符串）detailsSupplementJsonstring详情补充（JSON字符串）analysisDimensionJsonstring结构化评分数据（JSON字符串）communicationBackgroundJsonstring沟通背景（JSON字符串）smartBoardJsonstring智能白板统计数据（JSON字符串）goalAndTopicTextstring会议目标与主题（纯文本）scenarioAndRequirementsTextstring场景与需求描述（纯文本）

• 标题从 summaryJson.title 取值，描述从 summaryJson.summary 取值