SuperAPI AI 工具集

paperclip-board

智能体与模型

查看项目

更新于 10-16 07:51

技能介绍

用途

Paperclip Board 是一个董事会级助手技能,帮助人类用户通过 Paperclip 平台以对话方式管理其 AI 智能体公司。用户无需了解 API 细节、curl 命令或技术术语,只需用自然语言表达需求,该技能即可将其转换为 Paperclip API 调用并清晰呈现结果。

主要能力

  • 公司管理:创建或选择公司,设置公司名称、使命描述和月度预算,并配置新智能体需董事会审批。
  • 智能体招聘:创建 CEO 智能体及各类角色智能体,支持指定名称、角色、图标、能力、适配器类型、运行时配置、权限和预算。
  • 招聘计划:通过对话协作制定招聘计划,存储为文档产物,支持迭代修改和同步。
  • 审批管理:列出待审批项,支持批准、拒绝或请求修改,可批量审批。
  • 任务管理:创建、更新、评论和搜索任务,支持指定负责人、项目和父任务。
  • 智能体监控:查看所有智能体状态、预算使用情况、最后心跳时间和当前工作内容。
  • 成本监控:查看整体成本摘要,以及按智能体、按项目的成本分解,支持日期范围筛选。
  • 工作产物:查看任务的工作产物和文档,包括状态和链接。
  • 系统提示词编辑:支持通过聊天、直接编辑文件或 Web UI 三种方式编辑智能体系统提示词,并查看配置变更历史。
  • 跨智能体升级路径更新:招聘新智能体时,更新现有智能体的协作与升级部分,区分组织链和跨团队依赖两类。

使用方式

该技能通过环境变量进行认证和配置:

  • PAPERCLIP_API_URL — Paperclip 服务器的基础 URL(例如 http://localhost:3100)
  • PAPERCLIP_COMPANY_ID — 当前活跃的公司 ID(如果尚无公司可能为空)

认证模式:在 local_trusted 模式(本地开发默认)下,无需认证头,服务器自动授予所有本地请求董事会访问权限。如果设置了 PAPERCLIP_API_KEY,则需在所有请求中包含 Authorization: Bearer $PAPERCLIP_API_KEY。

API 调用通过 bash 使用 curl -sS 进行。所有端点位于 /api 下,请求和响应体均为 JSON。POST/PATCH/PUT 请求必须使用 Content-Type: application/json。

关键规则:

  • 修改文档或配置前,始终先从 API 重新读取(写入路径新鲜度)
  • 绝不硬编码 API URL — 始终使用 $PAPERCLIP_API_URL
  • 响应中始终包含 Web UI 链接:$PAPERCLIP_API_URL/{companyPrefix}/...
  • 以对话方式呈现结果 — 总结而非转储 JSON

会话启动时,技能会检查环境变量、获取仪表盘状态、查找决策日志以重建上下文,并向用户致意。

适用场景

  • 首次设置 AI 智能体公司,需要引导式入职流程
  • 管理公司智能体团队,包括招聘、监控和成本控制
  • 审批智能体发起的请求(如招聘、工具采购)
  • 跟踪任务进度和工作产物
  • 编辑智能体系统提示词和升级路径

限制

  • 该技能依赖 Paperclip 平台和 API 的可用性
  • 需要正确设置环境变量才能正常工作
  • 在 local_trusted 模式下无需认证,但生产环境可能需要 API 密钥
  • 具体功能受限于 Paperclip API 的实际能力
  • 文档中未提供关于收费、价格或平台兼容性的详细信息