Skills System
Overview
Cici Agent completes various automation tasks through 21 skills.
Skill Categories
Search (2)
search_notes
Search notes by keywords.
{
"name": "search_notes",
"parameters": {
"query": "search keywords",
"category": "category (optional)",
"tags": ["tag list (optional)"]
}
}semantic_search
Search notes semantically.
{
"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.
{
"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 resultsCombined 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 resultsSkill Priority
When multiple skills are available, Cici selects them in this priority order:
- Exact match: The skill description best matches the request
- Execution cost: Prefer simpler skills
- Historical success rate: Prefer skills with higher success rates
Error Handling
Skill Execution Failure
{
"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