SuperAPI AI 工具集

alibabacloud-aidbs-dgate-skill

部署与运维

查看项目

更新于 10-15 19:54

技能介绍

用途:这是一个引导型 Skill,负责把 Agent 接入阿里云 Agent Data Gateway(Dgate)。它提供两条接入路径:连接托管的 Streamable HTTP MCP 服务,或安装 dgate CLI 及配套的托管 dgate-cli Skill/Rule 包。业务操作指引不在此处重复,接入完成后应使用已连接的 MCP 工具说明或本地 dgate-cli 技能。所需 RAM 权限声明见 references/ram-policies.md。

路径选择:若已连接专用 Dgate MCP 工具,则无需安装任何东西,直接验证连接并使用;云端、沙箱等不便安装二进制的托管 Agent 优先使用托管 MCP 服务;本地 Agent IDE 或用户明确要求 dgate 命令时使用 CLI 路径。用户选定路径后应遵从,不得因 MCP 可用就擅自安装 CLI,也不得用 MCP 替代用户要求的 CLI 安装。

MCP 路径:检测 Agent 宿主及其 MCP 配置面,保留所有现有 MCP 服务器与无关设置。从控制台获取目标 Region 和与之匹配的 AccessToken,AccessToken 视为机密,不得要求用户粘贴到聊天、打印或写入源码、日志、URL、截图、产物,应通过宿主的加密密钥或请求头配置输入。配置名为 dgate 的 Streamable HTTP 服务器,URL 形如 https://dgate-mcp-<REGION>.aliyuncs.com/mcp/dgate,请求头为 Authorization: Bearer <ACCESS_TOKEN>,例如 cn-hangzhou 使用 https://dgate-mcp-cn-hangzhou.aliyuncs.com/mcp/dgate,端点 Region 与 AccessToken Region 必须一致。修改宿主 MCP 配置需用户明确批准。重载配置后确认 dgate 连接、工具列表被发现,并调用只读的 acl_whoami 工具,三项检查全部通过才报告成功;失败时保留错误码、简短摘要和请求或追踪 ID,且不暴露 AccessToken。

CLI 路径:阅读官方安装指南 https://d.tb.cn/install_cli.md 并按其当前说明执行。检测目标操作系统与 Agent IDE,支持的 --install-ide 值包括 codex、cursor、qoder、qoderwork、claude、copaw、codebuddy、opencode,无法检测时再询问。从控制台获取目标 Region 和一次性安装令牌,令牌同样视为机密。安装或运行下载的软件需用户明确批准。macOS 或 Linux 使用 curl --connect-timeout 10 --max-time 120 -fsSL https://d.tb.cn/i.sh | bash -s -- --install-token "$DGATE_INSTALL_TOKEN" --region "$DGATE_REGION" --install-ide codex;Windows PowerShell 使用 Invoke-RestMethod -Uri https://d.tb.cn/i.ps1 -OutFile "$env:TEMP\i.ps1" -TimeoutSec 120 后执行 & "$env:TEMP\i.ps1" --install-token $env:DGATE_INSTALL_TOKEN --region $env:DGATE_REGION --install-ide codex。托管环境已提供 DGATE_ACCESS_TOKEN 和 DGATE_REGION 时可直接使用;仅刷新二进制与技能而不启动 Quick Start 时加 --skip-quickstart --install-ide <detected-ide>,不要把 AccessToken 放在命令行。

验证:安装器可能把 dgate 放在 PATH 之外,先用 command -v dgate 解析,缺失时在 /home/*/.local/bin/dgate 或 /root/.local/bin/dgate 定位并绑定绝对路径复用。依次运行 dgate version、dgate install skills --check --agents codex、dgate acl role current -o json,将 codex 替换为检测到的 IDE,三项均成功才报告成功;若修复 PATH 需新终端应说明。本引导技能不执行业务操作。