SuperAPI AI 工具集

connect-ai-confluence

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能为通过 CData Connect AI 查询 Confluence 数据提供专门指导,适用于页面、空间、内部文档、会议记录、评论、附件、页面层级、作者与编辑信息、内联任务、标签等场景。

前置条件:必须先加载 connect-ai-base 技能;若当前环境未加载、未启用或未安装,应停止任务并提示用户安装启用。该技能替代 Confluence 驱动的 getInstructions,识别连接后直接进行 schema 发现(getTables / getColumns)。

主要能力:Confluence 为单 schema 驱动,schema 名为 Confluence。核心表包括 Spaces、Pages、Blogposts、Comments、Attachments、Users、Groups;视图包括 PageChildren、PageAncestors、PageComments、PageContents、Labels、Tasks、ViewsAnalytics、ViewersAnalytics、Contributors、SpacePermissions、AuditRecords、Whiteboards 等。页面正文位于 Pages.Storage,为 storage 格式 XHTML,含 ac:* 宏标签。

使用方式:典型流程为先定位空间,再查页面,再按日期、作者或状态过滤,最后取正文、评论或附件。示例:SELECT * FROM [YourConnection].[Confluence].[Spaces] LIMIT 10。层级遍历优先使用 PageChildren / PageAncestors 视图,按 PageId 过滤;Labels、ViewsAnalytics 等视图必须带 ContentId、ContentType 或 LabelName 过滤,否则报错。

限制:Pages 表不返回历史版本,仅返回最新版本行,PreviousVersion* 只带上一版本元数据;完整版本历史需使用 Confluence UI 或 REST API。Users 视图仅适用于 Confluence Cloud。Server / Data Center 部署的列集可能不同,需先用 getColumns 验证。Pages.ParentId 用整数字面量过滤可能断开 MCP 连接,应使用带引号的字符串字面量或改用 PageChildren 视图。部分 CreatedByUserName、LastUpdatedUserName 等列已弃用或可能返回 NULL,建议使用 PublicName 或 AccountId 列。跨空间查询可能开销较大,应缩小时间过滤范围。