万方数据搜索技能
本技能提供万方数据平台的文献检索能力，支持：
- 文献关键词检索
- 文献详情获取
- 基于语义的向量检索
完整 API 说明请参考：
👉 reference/api-catalog.md
该文档包含：
- API 接口地址
- 请求参数
- 返回结构
- 文献类型说明
工具脚本
scripts/wf_data_query.py- 文献关键词检索scripts/wf_data_get_doc.py- 获取文献详情scripts/wf_data_vector_search.py- 向量语义检索
认证信息
所有接口需要以下请求头：
| Header | 说明 |
|---|---|
| X-Ca-AppKey | 应用 Key |
| Authorization | APPCODE 认证码 |
| Content-Type | application/json |
工具说明
1. 文献检索 (使用wf_data_query)
搜索万方数据库中的文献资源。
该工具适用于：
- 文献检索
- 按关键词搜索论文
- 按文献类型筛选
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 检索关键词 |
| collections | string[] | 否 | 文献类型 |
| rows | int | 否 | 返回条数 |
| start | int | 否 | 起始位置 |
可用 collections
| collection | 说明 |
|---|---|
| OpenPeriodical | 期刊论文 |
| OpenPeriodicalChi | 中文期刊 |
| OpenPeriodicalEng | 英文期刊 |
| OpenThesis | 学位论文 |
| OpenConference | 会议论文 |
| OpenPatent | 专利 |
| OpenClaw | 法规 |
| OpenCstad | 成果 |
| OpenStandard | 标准 |
| OpenMagazine | 刊名 |
| OpenMeeting | 会议名录 |
| OpenNstr | 科技报告 |
| OpenVideo | 视频 |
| OpenFZLocalChronicle | 方志 |
| OpenFZLocalChronicleItem | 方志条目 |
更多字段和高级参数请参考：
👉 reference/api-catalog.md
2. 获取文献详情 (wf_data_get_doc)
根据文献 ID 获取文献详细信息。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| collection | string | 是 | 文献资源库 |
| doc_id | string | 是 | 文献 ID |
3. 向量语义搜索 (wf_data_vector_search)
通过自然语言进行语义搜索，系统会匹配语义相似的论文片段。
适用于：
- 自然语言搜索
- 研究问题检索
- 语义相关文献发现
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query_text | string | 是 | 自然语言查询 |
| collections | string[] | 否 | 全文资源库 |
可用全文 collections
| collection | 说明 |
|---|---|
| OpenPeriodicalFulltext | 期刊全文 |
| OpenThesisFulltext | 学位论文全文 |
| OpenConferenceFulltext | 会议论文全文 |
| OpenPatentFulltext | 专利全文 |
| OpenClawFulltext | 法规全文 |
| OpenStandardFulltext | 标准全文 |
| OpenLocalchronicleFulltext | 方志全文 |
推荐调用流程
对于科研问题，建议 Agent 使用以下流程：
用户问题
↓
wf_data_vector_search（语义检索）
↓
获取文献ID
↓
wf_data_get_doc（获取文献详情）
↓
整理研究结果
对于精准关键词搜索：
用户关键词
↓
wf_data_query
↓
获取文献ID
↓
wf_data_get_doc
返回结果
所有接口返回 JSON 数据。
典型结构：
{
"documents": [],
"num_found": 120
}
注意事项
- 请确保配置正确的 API 认证信息
- 向量搜索适合语义问题检索
- 关键词检索适合精确查找
- 建议 rows 不超过 50