Skip to content

技能系统 ​

概述 ​

Cici Agent 通过 21 种技能完成各种自动化任务。

技能分类 ​

搜索类(2 个) ​

search_notes ​

关键词搜索笔记。

json
{
  "name": "search_notes",
  "parameters": {
    "query": "搜索关键词",
    "category": "分类(可选)",
    "tags": ["标签列表(可选)"]
  }
}

语义搜索笔记。

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 按以下优先级选择:

  1. 精确匹配:技能描述与请求最匹配
  2. 执行成本:优先选择简单的技能
  3. 历史成功率:优先选择成功率高的技能

错误处理 ​

技能执行失败 ​

json
{
  "status": "error",
  "error": "错误信息",
  "retryable": true
}

自动重试 ​

可重试的错误会自动重试(最多 3 次)。

最佳实践 ​

明确指令 ​

给 Cici 清晰的指令,帮助选择正确的技能。

分步执行 ​

复杂任务可以分步指示,提高准确率。

检查结果 ​

技能执行后检查结果是否符合预期。

故障排查 ​

Q: 技能执行失败 ​

查看错误日志,确认参数正确。

Q: 技能响应慢 ​

  • 检查 AI 服务连接
  • 检查数据库性能
  • 减少单次处理量

Q: 技能结果不准确 ​

  • 调整查询参数
  • 使用更精确的描述
  • 尝试其他技能