SuperAPI AI 工具集

pipa-connectors

通用与其它

查看项目

更新于 10-16 00:02

技能介绍

用途:pipa-connectors 是一项操作型技能,用于设置、检查、说明或排查 Pipa 连接的工具。它不承载业务职责,业务任务由业务通道负责,composio-mcp 负责实时应用发现、授权与操作。仅在显式调用该技能或由 pipa-manage 委派时使用,不应由通用语言触发。

主要能力:读取并维护 ~/.pipa/CONNECTORS.md,记录所选“能力到工具”的映射。~~ 前缀表示通过全局映射解析的能力占位符,不是工具包标识。能力类别包括 ~~chat、~~email、~~calendar、~~project tracker、~~code hosting、~~knowledge base、~~cloud storage、~~CRM、~~support platform、~~content platform、~~payments、~~time tracking。文中还给出业务通道与常见连接器类别的对应关系,如获取工作、定义工作、交付工作、获取付款、留住客户、改进运营等。

使用方式:存在 ~/.pipa/CONNECTORS.md 时读取它;通过 composio-mcp 发现受支持工具包与活动连接状态,并在任何实时检查前查看完整选定工具架构。将活动连接映射到相关能力类别,仅在多个工具可填入同一类别或映射不清晰时询问。写入前展示确切的连接器映射差异,并要求对该差异单独明确批准;应用批准的差异后验证写入并报告成功或失败。

输出契约包含:连接器目标、目标应用或工具包、所需权限类别、当前连接状态(connected、needs-auth、declined、unavailable、failed、not-reviewed、TBD)、连接器映射更新或 TBD、设置或授权步骤、写入/发布/通知的安全说明、实时检查的来源,以及每个请求来源的状态(used、partial、stale、empty、declined、unavailable、failed;范围外才用 not-requested),还有拟议差异、批准状态与确认写入结果。

限制与安全规则:不得在未获工具返回状态或验证运行时证据时声称活动状态;不要向用户索要原始密钥;不要用写入、发送、发布、提醒、触发或财务变更来测试连接;连接器映射是持久工具选择偏好,不是实时访问证明;发现与验证必须保持只读;映射仅依据已验证发现结果或用户明确选择更新,不得猜测;连接器映射中绝不存储凭据、授权链接、密钥或实时状态。连接映射写入是独立的外部状态变更,需在写入前对确切差异单独明确批准,完成授权链接不等于映射写入批准。官方细节(如费用、平台支持范围、具体安装命令)暂未提供。