灵犀Note录音文件查询 Skill

指令路由表

自然语言路由

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

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

API 路由表

录音文件

> 完整 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
}

常见错误码（500系列）

实现说明

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

1. 请求头：必须携带 AuthorizationLyk 字段，格式为 lyk-xxx
2. 请求参数：文档中未明确说明的参数，一律不传。两个列表接口均为无参请求
3. 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()

响应字段

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

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

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