用途:通过 Membrane CLI 调用 Edlink 通用 API,访问来自多种学习管理系统的教育数据,避免为每个平台单独做集成。涉及对象包括机构(Institution)、学生(Student)、教师(Teacher)、课程(Course)、作业(Assignment)、提交(Submission)。
主要能力:Membrane 负责认证与凭据刷新,可先搜索动作再运行,也可在动作不覆盖需求时通过代理直接请求 Edlink API;认证与凭据刷新由 Membrane 在服务端管理。
必要用法:先安装 CLI:npm install -g @membranehq/cli@latest;登录:membrane login --tenant --clientName=<agentType>;无交互环境会打印授权 URL,完成后执行 membrane login complete <code>。创建连接:membrane connection ensure "https://ed.link/" --json;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至非 BUILDING;READY 即可用,CLIENT_ACTION_REQUIRED 按 clientAction 处理。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作: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 等选项。任意命令加 --json 可获得机器可读输出。
适用场景:开发者或 AI 智能体需要与 Edlink 数据交互、管理教育数据记录或自动化相关工作流时。
限制:动作与参数需按实际搜索结果确定;涉及用户认证的步骤需用户在浏览器完成;未提及具体定价、配额、数据覆盖范围或速率限制。官方文档:https://docs.edlink.com/