灵犀Note录音文件查询 Skill

指令路由表

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

自然语言路由

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

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

API 路由表

录音文件

| 方法 | 路径 | 说明 | 详细文档 | |------|------|------|----------| | GET | /api/api/apiKeyConfig/innerApi/userRecordingQuery | 销售录音列表查询 | references/list.md | | GET | /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 有效性

通用错误处理

录音文件接口返回格式：

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

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

常见错误码（500系列）

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

实现说明

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

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

请求示例

销售录音（无参）：

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

会议录音（无参）：

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

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()

响应字段

| 字段 | 类型 | 说明 | |------|------|------| | code | int | 状态码，200 为成功 | | message | string | 消息 | | msg | string | 消息 | | data | array | 录音数据数组 | | succeed | boolean | 是否成功 |

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

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

| 字段 | 类型 | 说明 | |------|------|------| | id | string | 录音文件ID | | publicUrl | string | 公网URL（音频文件地址） | | transcriptionSegmentsJson | string | 带时间戳的录音分析分段（JSON字符串） | | summaryJson | string | 全文摘要（JSON字符串），解析后含 title 和 summary | | keyPointsJson | string | 重点内容（JSON字符串） | | insightAnalysisJson | string | 洞察分析（JSON字符串） | | mindMapJson | string | 思维导图（JSON字符串） | | translationJson | string | 翻译（可能为null） | | speakerSummaryJson | string | 按说话人总结（JSON字符串） | | briefSummaryJson | string | 极简总结（JSON字符串） | | meetingMinutesJson | string | 会议纪要（可能为null） | | bantRaw | string | BANT销售分析（可能为null） | | competitorSwotRaw | string | SWOT分析（可能为null） | | actionItemsRaw | string | 待办事项（JSON字符串） | | speakerNamesJson | string | 说话人名称映射（可能为null） | | dialogExcerptsJson | string | 对话节选（JSON字符串） | | highlightDialogueJson | string | 高光对话（JSON字符串） | | speechDurationJson | string | 说话人时长占比（JSON字符串） | | emotionCurveJson | string | 客户情绪曲线（JSON字符串） | | detailsSupplementJson | string | 详情补充（JSON字符串） | | analysisDimensionJson | string | 结构化评分数据（JSON字符串） | | communicationBackgroundJson | string | 沟通背景（JSON字符串） | | smartBoardJson | string | 智能白板统计数据（JSON字符串） | | goalAndTopicText | string | 会议目标与主题（纯文本） | | scenarioAndRequirementsText | string | 场景与需求描述（纯文本） |

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