| name | list-documents |
| description | 列出当前对话中的所有文档名称，包括文件名、上传时间、状态等信息但是查看不了具体内容。 Use when this capability is needed. |
| metadata | {"author":"1firecracker"} |
文档列表工具
用途
列出当前对话中已上传的所有文档及其基本信息。这是一个辅助工具，通常在调用其他工具之前使用。
触发条件
当用户表达以下意图时，应该使用此工具：
- "列出所有文档"、"显示文件列表"
- "有哪些文档？"、"我上传了什么文件？"
- 当需要获取
file_id 以供其他工具使用时
参数说明
此工具不需要额外参数。conversation_id 由系统自动注入。
使用规则
1. 作为前置查询
当其他工具需要 document_ids 参数，但用户只提供了文件名时：
- 先调用
list_documents 获取文档列表
- 从结果中匹配文件名，提取
file_id
- 再调用目标工具
2. 结果展示
向用户展示文档列表时，使用友好的格式，不要直接暴露技术细节（如完整的 file_id）。
示例
示例 1: 用户查看文档
用户: "我上传了哪些文件？"
调用: list_documents({})
回复: "您上传了 3 个文档：1. Lecture1.pdf 2. Lecture2.pdf 3. Notes.docx"
示例 2: 为其他工具获取 file_id
用户: "帮我画 Lecture1.pdf 的思维导图"
步骤:
- 调用
list_documents({}) -> 获取 [{"file_id": "abc123", "filename": "Lecture1.pdf"}, ...]
- 调用
generate_mindmap({"document_ids": ["abc123"]})
返回格式
{
"status": "success",
"message": "成功列出 3 个文档",
"result": "当前对话共有 3 个文档：\n1. Lecture1.pdf (1.2 MB) - 已完成\n...",
"documents": [
{
"file_id": "abc123-def456-ghi789",
"filename": "Lecture1.pdf",
"upload_time": "2024-01-15 10:30:00",
"status": "completed",
"file_type": "pdf",
"file_size": 1258000
}
],
"document_count": 3
}
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
