backboard: 为助理集成 Backboard.io 的线程与记忆功能

name: backboard
description: 通过本地后端（运行于 http://localhost:5100）集成 Backboard.io，实现助手、对话线程、记忆存储和文档 RAG 功能。

工具

此技能连接到一个本地 Flask 后端，该后端封装了 Backboard SDK。后端必须在 http://localhost:5100 上运行。

backboard_create_assistant

创建一个新的 Backboard 助手，需指定名称和系统提示。

参数：
- name (字符串，必需)：助手的名称
- system_prompt (字符串，必需)：助手的系统指令

示例：

{
  "name": "支持机器人",
  "system_prompt": "你是一个乐于助人的客户支持助手。"
}

backboard_list_assistants

列出所有可用的 Backboard 助手。

参数： 无

backboard_get_assistant

获取特定助手的详细信息。

参数：
- assistant_id (字符串，必需)：助手的 ID

backboard_delete_assistant

删除一个助手。

参数：
- assistant_id (字符串，必需)：要删除的助手 ID

backboard_create_thread

为助手创建一个新的对话线程。

参数：
- assistant_id (字符串，必需)：要为其创建线程的助手 ID

backboard_list_threads

列出所有对话线程，可按助手筛选。

参数：
- assistant_id (字符串，可选)：按助手 ID 筛选线程

backboard_get_thread

获取一个线程及其消息历史记录。

参数：
- thread_id (字符串，必需)：线程的 ID

backboard_send_message

向线程发送消息并获取回复。

参数：
- thread_id (字符串，必需)：线程的 ID
- content (字符串，必需)：消息内容
- memory (字符串，可选)：记忆模式 - "Auto"、"Readonly" 或 "off"（默认："Auto"）

backboard_add_memory

为助手存储一条跨对话持久化的记忆。

参数：
- assistant_id (字符串，必需)：助手的 ID
- content (字符串，必需)：要存储的记忆内容
- metadata (对象，可选)：记忆的附加元数据

示例：

{
  "assistant_id": "asst_123",
  "content": "用户偏好 Python 编程和深色模式界面",
  "metadata": {"category": "preferences"}
}

backboard_list_memories

列出助手的所有记忆。

参数：
- assistant_id (字符串，必需)：助手的 ID

backboard_get_memory

获取特定记忆。

参数：
- assistant_id (字符串，必需)：助手的 ID
- memory_id (字符串，必需)：记忆的 ID

backboard_update_memory

更新现有记忆。

参数：
- assistant_id (字符串，必需)：助手的 ID
- memory_id (字符串，必需)：记忆的 ID
- content (字符串，必需)：记忆的新内容

backboard_delete_memory

删除一条记忆。

参数：
- assistant_id (字符串，必需)：助手的 ID
- memory_id (字符串，必需)：要删除的记忆 ID

backboard_memory_stats

获取助手的记忆统计信息。

参数：
- assistant_id (字符串，必需)：助手的 ID

backboard_upload_document

向助手或线程上传文档以用于 RAG（检索增强生成）。

参数：
- assistant_id (字符串，可选)：助手的 ID（使用此参数或 thread_id）
- thread_id (字符串，可选)：线程的 ID（使用此参数或 assistant_id）
- file_path (字符串，必需)：文档文件的路径

支持的文件类型： PDF, DOCX, XLSX, PPTX, TXT, CSV, MD, PY, JS, HTML, CSS, XML, JSON

backboard_list_documents

列出助手或线程的文档。

参数：
- assistant_id (字符串，可选)：助手的 ID
- thread_id (字符串，可选)：线程的 ID

backboard_document_status

检查已上传文档的处理状态。

参数：
- document_id (字符串，必需)：文档的 ID

backboard_delete_document

删除一个文档。

参数：
- document_id (字符串，必需)：要删除的文档 ID

使用说明

当用户询问以下内容时：

记忆操作

• "记住……" 或 "存储这个……" → 使用 backboard_add_memory
• "你记得关于……的什么？" → 使用 backboard_list_memories 或 backboard_get_memory
• "忘记……" 或 "删除记忆……" → 使用 backboard_delete_memory
• "更新我的偏好……" → 使用 backboard_update_memory

文档操作

• "上传这个文档" 或 "索引这个文件" → 使用 backboard_upload_document
• "我有哪些文档？" → 使用 backboard_list_documents
• "我的文档处理好了吗？" → 使用 backboard_document_status

助手管理

• "创建一个新助手" → 使用 backboard_create_assistant
• "列出我的助手" → 使用 backboard_list_assistants
• "删除助手" → 使用 backboard_delete_assistant

对话线程管理

• "开始一个新对话" → 使用 backboard_create_thread
• "显示对话历史" → 使用 backboard_get_thread
• "向线程发送消息" → 使用 backboard_send_message

通用指南

1. 操作成功后，始终向用户确认。
2. 创建助手时，建议使用有意义的名称和系统提示。
3. 上传文档前，请先验证文件类型是否受支持。
4. 使用记忆功能时，向用户说明正在存储什么信息。
5. 应在用户上下文中存储/跟踪线程 ID 和助手 ID。

示例

示例 1：存储用户偏好

• 用户："记住我偏好深色模式和 Python 代码示例"
• 操作：调用 backboard_add_memory，内容为 "用户偏好深色模式界面和 Python 代码示例"，元数据为 {"category": "preferences"}
• 响应："我已存储您的偏好。您偏好深色模式和 Python 代码示例。"

示例 2：创建一个助手

• 用户："创建一个代码审查助手"
• 操作：调用 backboard_create_assistant，名称为 "代码审查员"，系统提示为 "你是一名专业的代码审查员。分析代码中的错误、性能问题和最佳实践。提供建设性反馈。"
• 响应："已创建您的代码审查员助手（ID：asst_xxx）。它已准备好审查代码并提供反馈。"

示例 3：上传并查询文档

• 用户："上传我的项目文档，然后告诉我它涵盖了什么内容"
• 操作 1：调用 backboard_upload_document 上传文件
• 操作 2：等待处理，使用 backboard_document_status 检查状态
• 操作 3：使用 backboard_send_message 并设置 memory="Auto" 来查询文档内容
• 响应："我已上传并索引了您的文档。根据内容，它涵盖了……"

示例 4：开始一个线程化对话

• 用户："开始与我的支持助手进行新对话"
• 操作：使用助手 ID 调用 backboard_create_thread
• 响应："已启动新的对话线程（ID：thread_xxx）。您现在可以向您的支持助手发送消息了。"

后端设置

此技能需要一个正在运行的后端服务器。启动步骤如下：

1. 设置 BACKBOARD_API_KEY 环境变量。
2. 导航到后端目录。
3. 运行 ./start.sh。

后端将在 http://localhost:5100 上可用。

API 端点参考