【AI软件】智能体工具举例

# 古风AI助手 · 智能体工具管窥

## 一、工具系统概述
【可无限扩展，逐步添加新工具】

本应用为AI角色配备了完整的工具调用能力。当您在与角色对话时提出需求，AI会自动判断并调用相应工具来完成任务，无需手动切换。支持单次调用和复合任务规划。

—

## 二、工具列表及使用方法

### 1. 保存笔记 (save_note)

**功能说明**：AI可以将对话中您认为重要的内容自动保存为笔记，也可以创建全新的笔记或更新已有笔记。

**触发方式**：向AI说“帮我记下来”、“保存这段内容为笔记”、“把刚才的话记成笔记”等。

**支持参数**：标题、内容、标签列表、更新已有笔记的ID

**示例对话**：
– “把今天的读书心得记成笔记，标签是‘读书’”
– “更新我之前那篇关于丹田呼吸的笔记，加上这段新内容”

—

### 2. 搜索知识库 (search_knowledge)

**功能说明**：在您上传的所有文档中搜索关键词，返回相关文档的名称、内容和摘要。

**触发方式**：向AI说“帮我搜索一下XXX”、“找找关于XXX的文档”等。

**支持参数**：搜索关键词、最多返回条数（默认5条）

**示例对话**：
– “帮我搜一下关于伤寒的文档”
– “知识库里有没有讲针灸的内容？”

—

### 3. 定时提醒 (text_reminder)

**功能说明**：设置倒计时提醒，时间到达后AI会在对话中主动发送提醒消息。

**触发方式**：向AI说“X分钟后提醒我XXX”、“帮我设个提醒”等。

**支持参数**：分钟数、提醒内容

**示例对话**：
– “30分钟后提醒我阅读【九宫解伤寒】”
– “一小时后叫我，该去给学生讲课了”

—

### 4. 总结笔记 (summarize_notes)

**功能说明**：自动总结最近一段时间内您记录的所有笔记，提取核心内容。

**触发方式**：向AI说“帮我总结最近的笔记”、“这几天我都记了什么”等。

**支持参数**：最近天数（默认7天）、最多笔记数（默认10篇）

**示例对话**：
– “总结一下我最近三天的笔记”
– “帮我看看这段时间记了哪些重要内容”

—

### 5. 获取当前时间 (get_current_time)

**功能说明**：获取当前真实时间，包括公历日期、时辰（子丑寅卯…）和季节信息。

**触发方式**：向AI说“现在什么时辰了”、“今天是什么日子”等。

**支持参数**：无

**示例对话**：
– “现在是什么时辰？”
– “今日是几月几号？”

—

### 6. 记住信息 (remember)

**功能说明**：AI会记住您告诉它的重要信息，下次对话时可以回忆起来。适用于：用户喜好、重要事实、待办事项、约定等。

**触发方式**：向AI说“记住XXX”、“我喜欢XXX”、“我的名字叫XXX”等。

**支持参数**：内容、类别（偏好/事实/待办/约定）、标签

**示例对话**：
– “记住我叫苏慕白”
– “我喜欢喝龙井茶，不爱碧螺春”
– “记住我下周三要去学校外讲六壬和六爻”

—

### 7. 回忆信息 (recall)

**功能说明**：根据关键词搜索AI之前记住的关于您的信息。

**触发方式**：向AI说“我之前说过什么”、“我有什么喜好”、“你记得XXX吗”等。

**支持参数**：关键词、类别限定、返回数量（默认5条）

**示例对话**：
– “我之前说过我叫什么名字？”
– “你记得我喜欢喝什么茶吗？”
– “关于我的讲课安排，你记得哪些？”

—

### 8. 遗忘信息 (forget)

**功能说明**：删除某条记忆，可以用记忆ID或关键词删除。

**触发方式**：向AI说“忘掉那件事”、“删除关于XXX的记忆”等。

**支持参数**：记忆ID 或 关键词

**示例对话**：
– “忘掉我刚才说的那件事”
– “删除所有关于测试的记忆”

—

### 9. 任务规划 (task_planner)

**功能说明**：将复杂任务分解为多个步骤并依次执行。用于需要多个工具配合完成的复合任务。

**触发方式**：向AI提出需要多步完成的任务，AI会自动分解执行。

**支持参数**：目标、步骤列表

**示例对话**：
– “帮我整理最近一周的笔记，然后总结重点，最后设个提醒明天再看”
– “搜索一下关于丹田呼吸的文档，然后把关键内容记成笔记”

—

### 10. 全能待办管理 (todo_pro)

**功能说明**：完整的任务管理系统，支持多种任务类型和激励机制。这是功能最丰富的工具之一。

**支持操作类型**：

**添加任务**：`添加待办：XXX`、`添加每日打卡：XXX`、`添加习惯：每天跑步30分钟，目标21天`

**列出任务**：`列出我的任务`、`查看待办`

**完成任务**：`完成任务1`、`打卡 XXX`（针对每日打卡）

**删除任务**：`删除任务1`

**查看统计**：`任务统计`、`我的进度`

**查看习惯进度**：`查看习惯`、`习惯进度`

**每周复盘**：`本周复盘`、`周报`

**番茄钟专注**：`番茄钟 start 25 读书`、`番茄钟 pause`、`番茄钟 resume`、`番茄钟 stop`、`番茄钟状态`

**查询积分**：`我的积分`、`积分多少`

**查看奖励**：`奖励列表`

**兑换奖励**：`兑换 每日箴言`、`兑换 静心一刻`

**积分规则**：
– 完成普通任务：+10分
– 完成每日打卡：+5分
– 完成一个番茄钟：+15分
– 连续完成习惯目标：额外奖励

**可兑换奖励**：
– 静心一刻（50分）：获得冥想引导词
– 定制诗词（100分）：AI为您写专属诗词
– 每日箴言（30分）：获得一句励志古语
– 古风壁纸（150分）：解锁精美壁纸
– 定制主题（300分）：自定义应用主题色

**示例对话**：
– “添加待办：去学校图书馆借书”
– “添加每日打卡：晨起跑步”
– “添加习惯：每天读书半小时，目标30天”
– “番茄钟 start 25 读伤寒论”
– “列一下我的任务”
– “完成任务1”
– “本周复盘”
– “我的积分多少？”
– “兑换 每日箴言”

—

### 11. 搜索笔记与文档 (search_notes)

**功能说明**：这是功能最强大的搜索工具，在您的笔记和知识库文档中全面搜索。支持全文搜索、标签搜索、时间范围筛选、高级语法、拼音首字母搜索等。

**触发方式**：向AI说“搜索一下XXX”、“查查笔记里有没有XXX”等。

**支持参数**：
– keyword：搜索关键词（支持+必须包含、-排除语法）
– source：搜索范围（笔记/文档/两者）
– searchType：搜索类型（全文/标题/内容/标签）
– days：时间范围（最近N天）
– maxResults：最大返回数（默认50）
– includeFullContent：是否返回完整内容
– orderBy：排序方式（相关度/日期/标题）
– highlight：是否高亮关键词
– deduplicate：是否去重
– includeTagStats：是否包含标签统计

**高级搜索语法**：
– `中医 +伤寒 -温病`：必须包含“伤寒”，排除“温病”
– `sh`：拼音首字母，可匹配“伤寒”、“上工”、“时辰”等
– `心 肝 脾`：空格表示AND，同时包含所有词

**示例对话**：
– “搜索一下关于阴阳五行的笔记”
– “在知识库里找‘脉诊’相关的内容”
– “搜索 +针灸 -艾灸，最近30天内的笔记”

—

## 三、工具使用注意事项

1. **无需手动调用**：AI会自动判断何时需要调用工具，您只需正常对话即可

2. **API密钥必需**：使用任何工具前，请先在设置中配置好API密钥

3. **多轮对话支持**：AI可以在一次对话中连续调用多个工具，也可以根据追问继续执行

4. **复合任务**：遇到复杂需求时，AI会自动使用任务规划工具分解步骤

5. **记忆持久化**：AI记住的信息会保存在本地，下次打开页面仍然有效

6. **积分系统**：完成任务会获得积分，积分可用于兑换各种奖励，激励您持续使用待办管理功能

—

## 四、快速上手示例

您可以这样与AI对话，体验工具功能：

> 用户：“帮我记一下，我叫李清照，喜欢婉约词风”

> AI：📝 已记住：我叫李清照，喜欢婉约词风

—

> 用户：“添加待办：写完一篇新词，每日打卡：晨起跑步”

> AI：✅ 已添加待办：写完一篇新词
> ✅ 已添加每日打卡：晨起跑步

—

> 用户：“番茄钟 start 30 填词”

> AI：🍅 番茄钟已开始！专注30分钟「填词」⏰ 结束时间：14:30 💡 完成后+15积分

—

> 用户：“搜索一下关于婉约词的笔记”

> AI：🔍 搜索“婉约词”找到 2 条结果：📝 笔记 (2条) 1. 📄 李清照词风分析 2. 📄 宋代婉约派…