Forge Connector 是一个用于构建和部署 Atlassian Forge Teamwork Graph 连接器应用的技能。它帮助开发者创建 graph:connector 类型的 Forge 应用,将外部数据摄取到 Atlassian 的 Teamwork Graph 中,从而让这些数据出现在 Rovo Search 和 Rovo Chat 里。
用途 该技能面向需要将外部系统数据接入 Atlassian 生态的开发者。通过构建连接器应用,外部数据源(如 Google Drive、ServiceNow、Salesforce、GitHub 等)中的内容可以被索引到 Teamwork Graph,并在 Rovo 搜索和聊天中被检索。
主要能力 技能提供了一套完整的工作流程,包括:环境准备检查(Node.js 22+、Forge CLI、登录状态);数据发现与对象类型映射(通过提问确定正确的 Teamwork Graph 对象类型,如 atlassian:document、atlassian:work-item、atlassian:message 等);脚手架生成连接器应用;定制生成的代码(编辑 src/index.js、manifest.yml、package.json);部署和安装应用;通过 Atlassian Administration 连接;使用 forge tunnel 监控日志。
关键规则 技能强调多项必须遵守的规则:应用必须安装到 Jira 站点,仅安装到 Confluence 无效;绝不在聊天中询问凭据,应引导用户在自己的终端运行 forge login;必须自行运行脚手架脚本;需要安装时始终询问用户的 Atlassian 站点 URL;断开连接时 Atlassian 会自动删除数据,应用只需清理本地状态;处理函数参数直接传递,配置值在 request.configProperties;使用 @forge/kvs 存储,不要用 @forge/storage;使用 @forge/teamwork-graph 的 graph 命名导出;validateConnectionHandler 必须返回 { success, message };function 声明属于 modules 下;formConfiguration 使用 form 数组和 type: header;作用域使用 read/write/delete:object:jira;设置 ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-connector;绝不忽略 setObjects/setUsers/setGroups 响应;保持访问控制 ID 一致;使用编排进行刷新调度;taskId 必须是有效 UUID;在调度前将 TaskInfo 写入 KVS,完成后不要删除;根据 response.error 判断编排响应。
使用方式 技能按步骤 0 到 7 顺序执行:步骤 0 检查前置条件;步骤 1 发现开发者空间;步骤 1.5 发现数据并映射到对象类型;步骤 2 生成连接器应用脚手架;步骤 3 定制生成的代码;步骤 4 部署和安装;步骤 5 通过 Atlassian Administration 连接;步骤 6 使用 forge tunnel 监控。
适用场景 适用于需要将外部数据源集成到 Atlassian Teamwork Graph 的开发者,特别是希望数据能在 Rovo Search 和 Rovo Chat 中被搜索的场景。支持多种对象类型,如文档、工作项、消息、项目、代码仓库、拉取请求、提交、设计文件、视频、日历事件、对话、客户组织、空间等。
限制 应用必须安装到 Jira 站点;forge create 需要交互式 TTY 选择开发者空间;forge developer-spaces list 在 Forge CLI 12.x 中不存在;每次 setObjects 调用最多 100 个对象;id 在每个 connectionId 中必须唯一;connectionId 在每次 graph.setObjects() 调用中必需;对于标记为不在 Rovo 中索引的类型(atlassian:build、atlassian:deployment、atlassian:test),对象不会出现在 Rovo Search 或 Rovo Chat 中。