SuperAPI AI 工具集

setting-up-relayfile

智能体与模型

查看项目

更新于 10-15 16:43

技能介绍

用途:Relayfile 将 Notion、Linear、Slack、GitHub 等适配器支持的提供方挂载为磁盘上的普通文件,使智能体通过文件系统读写,而不必调用 API。本技能是首次端到端设置的规范流程,也用于挂载异常时的诊断恢复。

主要能力:设置后文件出现在 <local-dir>/<provider>/... 下,例如 Notion 的 databases/<slug>--<id>/metadata.json(只读模式)、pages/<slug>--<id>/content.md(可读写)与 blocks/<id>.json。写回由文件写入自动触发。适配器提供 .adapter.md、.schema.json、.create.example.json 等发现文档,用于确认可写资源与创建载荷;new.json 并非特殊文件名,创建时应写入资源目录下任意非规范文件名。

使用方式:先确认 relayfile CLI 在 $PATH,运行 relayfile setup --provider notion --workspace my-agent --local-dir ~/relayfile-mount --no-open,再用 relayfile status my-agent 检查健康。本地智能体可设置 RELAYFILE_LOCAL_DIR 并指向该目录;远程或 SDK 访问可用 @relayfile/sdk 的 RelayFileClient 读写。仅读可跳过写回验证,需写则建议先做写回测试。新增集成前用 relayfile integration available --refresh 或 integration search 查询实时目录,不要猜测提供方名称。

适用场景:智能体读取或写回提供方内容,如总结 Notion 数据库、在 Notion 页面发布评论、更新 Linear 问题;人工在委派任务前搭建挂载;挂载不再反映变更时定位问题。

限制:需要访问 agentrelay.com/cloud、api.relayfile.dev、connect.nango.dev 及 Composio 端点;<local-dir>/.relay/ 为保留目录,禁止写入。本技能不涵盖自托管 relayfile、多工作区智能体,以及通过 relayfile 访问 GitHub 源码。Jira/Confluence 若报 cloudId 缺失,可用 integration set-metadata 设置 cloudId 与 baseUrl。清理时依次 stop、disconnect、workspace delete 并删除镜像目录。