SuperAPI AI 工具集

open-tag-admin

智能体与模型

查看项目

更新于 10-16 08:11

技能介绍

用途:Open Tag(admin)是 Open Tag 部署的控制台技能,既用于首次搭建,也用于日常运维,例如查看当前运行的机器人、更换后端或允许范围、添加数据源、把机器人移到另一个 Slack 频道,或调试一次运行。

架构:Brain 为所选 CLI 智能体后端(claude -p 或 codex exec);Memory 为 MFS 索引且经操作者授权的上下文(Slack 历史、仓库、文档、issue、数据库、对象存储等);Tools 为 MFS 连接器及后端在工作区被允许使用的显式工具。用户流程为:配置 MFS 源与允许范围,配置启用 Socket Mode 的 Slack 应用并邀请到沙箱频道,启动 Open Tag 桥接,在 Slack 线程中 @ 机器人,由桥接携带线程上下文和受限的 MFS 辅助脚本调用后端。该技能不直接调用模型 API,模型、工具与写权限均来自所选 CLI 后端。

前提:需已安装并运行 MFS 服务器(uv tool install mfs-server,然后 mfs-server run,绑定 127.0.0.1:13619,可用 curl -s 127.0.0.1:13619/healthz 检查),且至少有一个已索引数据源;Open Tag 只消费已索引范围,不自行配置连接器,添加源请用 mfs-ingest 技能。opentag_doctor.py 会在缺失时快速失败并给出提示。

搭建:阅读 references/slack-adapter.md 并按清单操作;创建或复用 Slack 应用,启用 Socket Mode,订阅 app_mention,添加所需 bot 权限并安装、邀请到频道;配置 MFS 记忆源并把 MFS_ALLOWED_SCOPES 设为运行时可用的确切源根;显式选择 OPENTAG_BACKEND(claude 或 codex);运行 python scripts/opentag_doctor.py --channel-id <channel-id> 并修复失败项;用 uv run --with slack-bolt python scripts/slack_socket_agent.py --backend <backend> 启动桥接,阅读其“当前运行内容”摘要,再用真实委派任务验证线程上下文、受限上下文检索与任务执行。

添加数据源:用 mfs-ingest 技能处理凭据并写入连接器配置,再把其根加入 MFS_ALLOWED_SCOPES。示例包括本地仓库/文档、Slack 历史、GitHub、Linear、Postgres 等,MFS 支持 20 多种连接器。

脚本职责:slack_socket_agent.py 接收 app_mention、读取线程、发布进度、调用后端并回帖;opentag_agent.py 构造非交互提示并调用后端;mfs_search.py 与 mfs_cat.py 调用 MFS HTTP API 做受限搜索与读取;opentag_memory.py 维护可选本地种子笔记并重新索引;opentag_doctor.py 做环境变量、Slack 访问、MFS 可达性、允许范围与后端可用性的预检。

限制:运行时每次提及都会启动新的 CLI 智能体,须遵循 references/runtime-agent.md;线程上下文是短期状态,持久上下文应来自允许的 MFS 范围;不要在技能中硬编码真实工作区名、频道 ID、用户 ID、本地绝对路径或客户项目细节。该技能不提供托管式治理、审计或审批流程。