Skip to content

Skills System

Overview

Cici Agent completes various automation tasks through 21 skills.

Skill Categories

Search (2)

search_notes

Search notes by keywords.

json
{
  "name": "search_notes",
  "parameters": {
    "query": "search keywords",
    "category": "category (optional)",
    "tags": ["tag list (optional)"]
  }
}

Search notes semantically.

json
{
  "name": "semantic_search",
  "parameters": {
    "query": "description of search intent"
  }
}

Reading (4)

read_note

Read the content of a single note.

list_notes

List notes.

list_categories

List the category tree.

list_tags

List tags.

Editing (3)

edit_note

Edit note content.

json
{
  "name": "edit_note",
  "parameters": {
    "note_id": "note ID",
    "content": "new content",
    "operation": "replace|append|prepend"
  }
}

rewrite_note

Rewrite a note to make it more concise, more detailed, or change its style.

merge_notes

Merge multiple notes into one.

Creation (3)

create_note

Create a new note.

create_category

Create a new category.

create_tag

Create a new tag.

Deletion (1)

delete_note

Delete a note.

Analysis (4)

summarize

Summarize note content.

extract_keywords

Extract keywords.

answer_question

Answer questions based on note content.

translate

Translate note content.

Organization (4)

move_note

Move a note to another category.

add_tags

Add tags to a note.

remove_tags

Remove tags from a note.

favorite_note

Favorite or unfavorite a note.

Skill Execution

Automatic Invocation

Cici automatically selects suitable skills based on user requests:

User: "Search for notes about AI"
→ Cici selects the search_notes skill
→ Executes the search
→ Returns results

Combined Invocation

Complex tasks combine multiple skills:

User: "Find all unfinished notes and summarize them"
→ list_notes (get notes)
→ filter (select unfinished notes)
→ summarize (summarize)
→ return results

Skill Priority

When multiple skills are available, Cici selects them in this priority order:

  1. Exact match: The skill description best matches the request
  2. Execution cost: Prefer simpler skills
  3. Historical success rate: Prefer skills with higher success rates

Error Handling

Skill Execution Failure

json
{
  "status": "error",
  "error": "error message",
  "retryable": true
}

Automatic Retry

Retryable errors are automatically retried up to 3 times.

Best Practices

Clear Instructions

Give Cici clear instructions to help it choose the correct skill.

Step-by-Step Execution

For complex tasks, provide step-by-step instructions to improve accuracy.

Check Results

After skill execution, check whether the results meet expectations.

Troubleshooting

Q: Skill execution failed

Check the error logs and confirm that the parameters are correct.

Q: Skill response is slow

  • Check AI service connection
  • Check database performance
  • Reduce the amount processed in a single request

Q: Skill results are inaccurate

  • Adjust query parameters
  • Use more precise descriptions
  • Try another skill