快速接入Agent数据网关
本文介绍如何通过安装命令快速完成 Agent 数据网关的接入配置。CLI 会自动申请访问令牌（Access Token）并写入本地安全凭证库，无需手动创建令牌或复制粘贴密钥。
适用范围
已开通 Agent 数据网关。
已在 Agent 数据网关中添加数据源。
操作步骤
一、获取安装命令
登录AI原生数据库服务控制台。
点击控制台左上角的
图标，在弹出的窗口中单击Agent 数据网关。在 Agent Gateway 控制台的左侧导航栏，选择身份与权限 > 我的Agent身份。
在快速接入页签下，选中CLI 安装。
说明本文以CLI安装方式为例进行说明。如果您需要通过 MCP 协议接入 Agent，请单击MCP 安装，获取自然语言或MCP接入的命令。
根据您的操作系统，单击macOS / Linux或Windows标签页，查看对应的安装命令。
根据您的接入方式，单击一行命令或自然语言标签页。
一行命令：将安装命令粘贴到终端执行，由您手动完成安装。
自然语言：将提示词粘贴给 AI IDE 中的 Agent，由 Agent 自动完成安装。
单击命令区域右侧的复制按钮，将安装命令复制到剪贴板。
安装命令中包含您专属的 install-token 和地域信息，请勿将此命令分享给他人，泄露可能导致安全风险。
install-token 存在有效期，页面会显示剩余有效时间。如果 install-token 已过期，请刷新页面重新获取安装命令。
二、安装 Agent 数据网关 CLI
在macOS或Linux上安装
打开终端（Terminal），粘贴从控制台复制的安装命令并执行。命令格式如下：
curl -fsSL https://d.tb.cn/i.sh | \
bash -s -- \
--install-token <your_install_token> \
--region <region>命令参数说明：
--install-token：您专属的安装令牌，由控制台自动生成并嵌入命令中。--region：Agent 数据网关所在地域，如cn-shanghai。
在Windows上安装
打开 PowerShell，粘贴从控制台复制的安装命令并执行。命令格式如下：
irm https://d.tb.cn/i.ps1 -OutFile $env:TEMP\install-dgate.ps1
& $env:TEMP\install-dgate.ps1 --install-token <your_install_token> --region <region>命令参数说明：
--install-token：您专属的安装令牌，由控制台自动生成并嵌入命令中。--region：Agent 数据网关所在地域，如cn-shanghai。
在AI IDE中通过自然语言安装
如果您使用 Qoder、Cursor、Claude Code 等 AI IDE，可以将自然语言页签中的提示词粘贴给 Agent，由 Agent 阅读安装说明并自动完成安装。提示词格式如下：
请阅读 https://d.tb.cn/install_cli.md，使用 install token <your_install_token> 安装 Agent 数据网关 CLI。Region: <region>。提示词中包含您专属的 install-token，请勿分享给他人，也不要提交到代码仓库。
三、验证接入结果
安装命令执行成功后，CLI 会自动完成以下操作。操作完成后，Agent 即可通过网关安全访问企业数据。
使用 install-token 兑换访问令牌（Access Token），注册 Agent 身份并写入本地安全凭证库。
执行快速配置命令
dgate quickstart，完成 Agent 和数据目录的初始化配置。
您可以通过以下方式验证接入结果：
在控制台左侧导航栏，选择身份与权限 > 我的Agent身份，单击我的Agent身份页签。如果列表中显示已创建的 AccessToken，说明已成功接入 Agent 数据网关。
在终端执行
dgate version，查看已安装的 CLI 版本。
CLI 的命令名为dgate，您可以执行dgate help查看可用命令。如需更换 Agent 或数据目录，可随时再次执行dgate quickstart重新配置。