SuperAPI AI 工具集

insightly

数据与分析

查看项目

更新于 10-16 00:26

技能介绍

用途:该技能用于让 AI 智能体与 Insightly(CRM 与销售平台)数据交互,面向销售、营销与项目管理团队的管理场景,可操作联系人、邮件、事件、线索、商机、组织、项目、任务、用户以及自定义对象、记录和关系。

主要能力:借助 Membrane CLI 调用 Insightly 接口,Membrane 负责认证与凭据自动刷新。常用流程包括:安装 CLI(npm install -g @membranehq/cli@latest);登录(membrane login --tenant --clientName=<agentType>,无头环境打印授权 URL,用户完成登录后用 membrane login complete <code> 收尾);建立连接(membrane connection ensure "https://www.insightly.com/crm/" --json,返回 connection id);连接状态为 BUILDING 时用 npx @membranehq/cli connection get <id> --wait --json 轮询,READY 即可用,CLIENT_ACTION_REQUIRED 时按 clientAction 指引完成认证或补充信息。

使用方式:用 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 按自然语言检索动作,结果含 id、name、description、inputSchema、outputSchema;用 membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json 执行动作。动作不覆盖时可经代理直接请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。

最佳实践与限制:优先使用 Membrane 的预置动作而非自建请求,避免向用户索取 API 密钥或令牌;先检索再构建。官方文档见 https://api.insightly.com/v3.1/Help。资料未提供具体动作清单、参数细节、支持的平台与价格信息。