| name | nlp |
| description | 当用户需要对中文或古汉语文本做分词、实体识别、词性标注、依存/语义分析、语义角色分析时,使用此技能。适用于信息抽取、结构化理解、文本预处理、规则验证与故障排查场景。不用于模型训练、微调、跨语言翻译或无文本输入的任务。 |
| metadata | {"builtin_skill_version":"1.0","qwenpaw":{"emoji":"🧠","requires":{}}} |
| tags | ["nlp","chinese","classical-chinese","ner","parsing"] |
| channels | ["all"] |
NLP 多任务内建技能
适用场景
当用户请求以下能力时使用本技能:
- 中文分词与古汉语分词
- 命名实体识别(人名、地名、机构名等)
- 词性标注(CTB/PKU/863)
- 依存句法、语义依存、短语结构
- 语义角色标注(SRL)
- 面向下游流程的文本结构化结果
统一调用入口
所有任务统一调用:
POST /api/nlp/tasks/{task_key}/run
示例最小请求体:
{
"text": "北京九录科技有限公司成立于2022年9月。",
"request_id": "nlp-skill-demo-001"
}
任务清单(task_key)
现代中文:
- tokenize
- ner
- pos_ctb
- pos_pku
- pos_863
- dep
- sdp
- con
- srl
古汉语:
- lzh_tok_fine
- lzh_tok_coarse
- lzh_lem
- lzh_pos_upos
- lzh_pos_xpos
- lzh_pos_pku
- lzh_dep
输入优先级
如果同时提供多个输入字段,按以下优先级选择:
- tokens_batch
- tokens
- texts
- text
约束:
- texts / tokens_batch 单次最多 5 条
- 输入为空时应先提示用户补充文本
推荐执行流程
1) 明确用户目标
先确认用户要的结果类型:
- 需要分词还是实体
- 需要语法关系还是语义角色
- 是现代中文还是古汉语
2) 选择 task_key
按目标选择最小必要任务,不做无关任务叠加。
3) 执行并解析
调用 /api/nlp/tasks/{task_key}/run 后,优先读取:
必要时查看高级信息:
- status
- reason_code
- duration_ms
- resolved_model
- preload_status
4) 给出用户可行动结论
输出应先给结论,再给证据:
- 先展示关键结果(如实体列表、分词序列、依存关系)
- 再补充必要说明(置信、异常、耗时)
故障处理规范
sidecar 未配置
若 status 非 ready 且 reason_code 指向 sidecar/环境未就绪:
- 明确告知当前 NLP 运行环境不可用
- 提示检查 NLP 配置页与运行时状态
- 不要伪造分析结果
冷启动与模型下载
首次调用可能耗时较长。处理原则:
- 先告知“模型初始化中”
- 超时后返回可执行建议(重试、切换轻量任务、检查缓存路径)
参数错误
若 task_key 不支持或输入不合法:
输出格式建议
- 默认输出:用户可直接使用的 NLP 结果
- 高级输出:折叠呈现调试字段(status/reason_code/duration_ms)
示例(简化):
{
"task": "ner",
"summary": "识别到 2 个实体",
"entities": [
{"text": "北京九录科技有限公司", "label": "ORG"},
{"text": "孟繁永", "label": "PERSON"}
],
"debug": {
"status": "ready",
"reason_code": "HANLP_READY",
"duration_ms": 42
}
}
CLI 调用示例
curl -s -X POST "http://127.0.0.1:8088/api/nlp/tasks/tokenize/run" \
-H "Content-Type: application/json" \
-d '{"text":"北京九录科技有限公司成立于2022年9月。","request_id":"nlp-cli-tokenize-001"}'
curl -s -X POST "http://127.0.0.1:8088/api/nlp/tasks/lzh_tok_fine/run" \
-H "Content-Type: application/json" \
-d '{"text":"赫赫九录,肇基京华。孟氏创立,岁在孟秋。","request_id":"nlp-cli-lzh-001"}'
禁止事项
- 不虚构模型输出
- 不在未调用接口时声称“已完成分析”
- 不将调试字段当作主业务结果返回给最终用户