技能系统
概述
Cici Agent 通过 21 种技能完成各种自动化任务。
技能分类
搜索类(2 个)
search_notes
关键词搜索笔记。
json
{
"name": "search_notes",
"parameters": {
"query": "搜索关键词",
"category": "分类(可选)",
"tags": ["标签列表(可选)"]
}
}semantic_search
语义搜索笔记。
json
{
"name": "semantic_search",
"parameters": {
"query": "搜索意图描述"
}
}读取类(4 个)
read_note
读取单个笔记内容。
list_notes
列出笔记列表。
list_categories
列出分类树。
list_tags
列出标签列表。
编辑类(3 个)
edit_note
编辑笔记内容。
json
{
"name": "edit_note",
"parameters": {
"note_id": "笔记 ID",
"content": "新内容",
"operation": "replace|append|prepend"
}
}rewrite_note
改写笔记(更简洁/更详细/改变风格)。
merge_notes
合并多个笔记为一个。
创建类(3 个)
create_note
创建新笔记。
create_category
创建新分类。
create_tag
创建新标签。
删除类(1 个)
delete_note
删除笔记。
分析类(4 个)
summarize
总结笔记内容。
extract_keywords
提取关键词。
answer_question
基于笔记内容回答问题。
translate
翻译笔记内容。
组织类(4 个)
move_note
移动笔记到其他分类。
add_tags
添加标签到笔记。
remove_tags
从笔记移除标签。
favorite_note
收藏/取消收藏笔记。
技能执行
自动调用
Cici 根据用户请求自动选择合适的技能:
用户:"搜索关于 AI 的笔记"
→ Cici 选择 search_notes 技能
→ 执行搜索
→ 返回结果组合调用
复杂任务会组合多个技能:
用户:"找出所有未完成的笔记并总结"
→ list_notes(获取笔记)
→ 过滤(筛选未完成)
→ summarize(总结)
→ 返回结果技能优先级
当多个技能可选时,Cici 按以下优先级选择:
- 精确匹配:技能描述与请求最匹配
- 执行成本:优先选择简单的技能
- 历史成功率:优先选择成功率高的技能
错误处理
技能执行失败
json
{
"status": "error",
"error": "错误信息",
"retryable": true
}自动重试
可重试的错误会自动重试(最多 3 次)。
最佳实践
明确指令
给 Cici 清晰的指令,帮助选择正确的技能。
分步执行
复杂任务可以分步指示,提高准确率。
检查结果
技能执行后检查结果是否符合预期。
故障排查
Q: 技能执行失败
查看错误日志,确认参数正确。
Q: 技能响应慢
- 检查 AI 服务连接
- 检查数据库性能
- 减少单次处理量
Q: 技能结果不准确
- 调整查询参数
- 使用更精确的描述
- 尝试其他技能