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: 技能结果不准确

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