@datadog/ai-setup-cli

中文文档
2.0.37发布于 2026/11/06Apache-2.0TypeScriptES Module近 30 天下载 2987

用于 Datadog 设置的互动工具

中文使用文档
文档目录7 节
  1. 快速启动
  2. 无头模式
  3. 参数
  4. 特定产品的论点
  5. 环境变量
  6. 支持的网站
  7. 支持产品

AI 设置 CLI

一个交互式的CLI,它使用AI代理自动与Datadog的仪器项目. 这个工具不是手工的SDK集成,而是利用克洛德来检测你的工程结构,修改你的代码库,并设置了Datadog产品——前端,后端,基础设施,AI,安全,以及CI测试.

快速启动

以交互方式运行 —— CLI 将您通过登录 / 注册, 选择一个产品组, 确认工作空间, 以及您的代码 :

npx @datadog/ai-setup-cli --site datadoghq.com

或者通过路过跳过采摘者 --product数字 :

npx @datadog/ai-setup-cli --site datadoghq.com --product rum

无头模式

使用 --headless 用于自动运行(CI、代理、脚本)。 它跳过 交互 UI 并需要两者 --site 财务报告和审定财务报表 --product数字 :

DD_API_KEY=... DD_APP_KEY=... \
  npx @datadog/ai-setup-cli \
  --headless \
  --site datadoghq.com \
  --product rum

设定 DD_API_KEY 财务报告和审定财务报表 DD_APP_KEY 环境变量(均为 )或设置 DD_ACCESS_TOKEN 用于预取的 OAuth 访问 符号(例如: pup 。 。 。 。 关闭所有三个 来使用浏览器 OAuth,是可能需要用户输入的唯一步骤。 远程或 完全未覆盖的环境, 请使用 env vars; 浏览器 OAuth 需要 a 本地主机召回。 钥匙和 DD_ACCESS_TOKEN 无法合并.

通过使用 --headless,您确认源代码上传和自动 命令执行被授权用于目标项目.

参数

参数说明需求默认
--site数据犬网站(参见 支持的网站(中文(简体) )对—— 说
--product产品到仪器(见 支持产品) (中文(简体) ). 要求为 --headless;否则,CLI会显示一个交互取取器.没有—— 说
--auto-approve自动批准所有未提示的 bash 命令没有false
--headless不使用交互式终端 UI 运行 。 要求数 --site 财务报告和审定财务报表 --product。通过 DD_API_KEY 编号 : DD_APP_KEY, (中文(简体) ), DD_ACCESS_TOKEN,或浏览 OAuth.没有false
-h, (中文(简体) ), --help显示帮助( 包括所有产品专用旗帜)—— 说—— 说

特定产品的论点

每种产品都可以在其 products/<name>/config.yaml。通过它们作为 --flag=value。完整集也由 --help。 。 。 .

产品旗帜说明
rum--app-id 编号 : --rum-application-idRUM 应用程序编号
rum--rum-client-tokenRUM 客户端符号
rum--rum-framework框架(例如:. react, (中文(简体) ), browser(中文(简体) )
error-tracking--app-idRUM 错误跟踪应用程序 ID
product-analytics--app-idRUM 应用程序编号
llm-obs--api-key数据犬 API 密钥
llm-obs--llm-obs-appLLM 应用程序名称 (DD_LLMOBS_ML_APP(中文(简体) )
infra-monitoring (库伯内特斯)--k8s-products 编号 : --enabled-products以逗号分隔的产品使(apm, (中文(简体) ), logs, (中文(简体) ), infrastructure, (中文(简体) ), otel) (中文(简体) ). --enabled-products 如果两者都设定了,则胜出.
infra-monitoring--k8s-distrogke, (中文(简体) ), eks, (中文(简体) ), minikube, (中文(简体) ), aks,, , , , , , , ,
infra-monitoring--k8s-cluster-name组名
infra-monitoring--k8s-env-nameDD_ENV 价值
infra-monitoring--k8s-library-versions譬如说. java:v1,python:v4,js:v5
infra-monitoring--k8s-target-namespaces要包含的命名空间
infra-monitoring--k8s-disabled-namespaces排除的命名空间
infra-monitoring--k8s-registry取代集装箱登记
docker--products以逗号分隔的产品(infra, (中文(简体) ), apm, (中文(简体) ), logs) (中文(简体) ). 默认 : infra,apm,logs。 。 。 .
docker--library-versions语言跟踪/图书馆版本
docker--envDD_ENV 价值
linux--products以逗号分隔的产品(infra, (中文(简体) ), apm, (中文(简体) ), logs, (中文(简体) ), otel) (中文(简体) ). 默认 : infra,apm,logs。 。 。 .
linux--envDD_ENV 价值
ecs--ecs-launch-typeECS发射类型(fargate, (中文(简体) ), ec2。如果省略则提示.
ecs--ecs-deployment-method部署方法terraform, (中文(简体) ), cdk, (中文(简体) ), cloudformation, (中文(简体) ), cli。如果省略则提示.
serverless--api-key数据犬 API 密钥
serverless--serverless-compute-typeaws-lambda, (中文(简体) ), gcp-cloud-run, (中文(简体) ), gcp-cloud-run-functions, (中文(简体) ), azure-container-apps (如果省略则会被推断)
serverless--serverless-runtimenodejs, (中文(简体) ), python, (中文(简体) ), java, (中文(简体) ), ruby, (中文(简体) ), dotnet, (中文(简体) ), go, (中文(简体) ), php (如果省略,则予以省略; php 只在云跑/容器应用程序上)
serverless--development-frameworkaws-cdk, (中文(简体) ), aws-sam, (中文(简体) ), serverless-framework, (中文(简体) ), terraform, (中文(简体) ), ci, (中文(简体) ), other (如果省略则会被推断)
test-optimization--api-key数据犬 API 密钥
ci_code_coverage--api-key数据犬 API 密钥

环境变量

变量说明数值
COLOR_THEME强制光/暗色主题( 默认: 自动检测通过) COLORFGBG,倒入黑暗中)light, (中文(简体) ), dark
COLOR_SCHEME切换颜色方案datadog (违约), high-contrast
DD_API_KEY数据犬 API 密钥 --headless; 必须设置为 DD_APP_KEYAPI 密钥
DD_APP_KEY数据犬应用密钥 --headless; 必须设置为 DD_API_KEY应用程序密钥
DD_ACCESS_TOKENOAuth 访问令牌 --headless; 无法与 DD_API_KEY 编号 : DD_APP_KEY访问令牌
AI_SETUP_CLI_PACKAGE_MANAGER无法检测时在无头模式下使用的软件包管理器npm, (中文(简体) ), yarn, (中文(简体) ), pnpm, (中文(简体) ), bun, (中文(简体) ), expo
AI_SETUP_CLI_CLAUDE_PERMISSION_MODE克劳德权限模式( 默认为 bypassPermissions; 使用 acceptEdits 当运行为根时)bypassPermissions, (中文(简体) ), acceptEdits

支持的网站

站点数值
美国1datadoghq.com
美国3us3.datadoghq.com
美国5us5.datadoghq.com
欧盟1datadoghq.eu
第1号附加议定书ap1.datadoghq.com
第2号附加议定书ap2.datadoghq.com
联合王国1uk1.datadoghq.com

支持产品

在交互式拾取器中显示, 分类如下:

组产品--product 价值
基础设施(选一)库伯涅斯infra-monitoring
基础设施夹克docker
基础设施链接linux
基础设施无服务器serverless
基础设施亚马逊ECSecs
前端监视卢姆rum
前端监视跟踪错误error-tracking
前端监视产品分析product-analytics
基于 LLM 的应用程序LLM 可观察性llm-obs
CI 测试测试优化test-optimization
CI 测试代码覆盖ci_code_coverage

隐藏在拾取器中,但可以通过 --product=<value>数字 :

产品--product 价值
App和API 保护app_and_api_protection
打开几何otel
工作室studio

版本与发布记录

@datadog/ai-setup-cli 共发布 49 个版本,首次发布于 2026/04/08;过去 12 个月发布了 49 个版本。

版本发布日期距今
2.0.37latest2026/11/065 天前
2.0.362026/11/046 天前
2.0.352026/10/3012 天前
2.0.342026/10/3012 天前
2.0.332026/10/2913 天前
2.0.322026/10/2813 天前

关于 @datadog/ai-setup-cli 的常见问题

@datadog/ai-setup-cli 是什么?

用于 Datadog 设置的互动工具

如何安装 @datadog/ai-setup-cli?

在项目目录运行 npm install @datadog/ai-setup-cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ai-setup-cli,可以用 npx ai-setup-cli 直接运行。

@datadog/ai-setup-cli 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@datadog/ai-setup-cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@datadog/ai-setup-cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@datadog/ai-setup-cli 可以商用吗?

@datadog/ai-setup-cli 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@datadog/ai-setup-cli 的下载量有多少?

根据 npm 官方下载统计,@datadog/ai-setup-cli 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,987 次,日均约 100 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@datadog/ai-setup-cli 还在维护吗?

最新版本 2.0.37 发布于 2026/11/06(5 天前);至今共发布 49 个版本,其中过去 12 个月发布了 49 个;首次发布于 2026/04/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。