@copado/ agentia-cli (英语)

Agentia 无头 Copado 工作流程的指令行界面(自动,环境,工作,管道,元数据,以及本地MCP).

• @copado/ agentia-cli (英语)
• 使用量
• 本地 MCP 服务器
• 本地质量门
• 许可证
• 图标

使用量

$ npm install -g @copado/agentia-cli@latest --registry https://registry.npmjs.org --@copado:registry=https://registry.npmjs.org
$ agentia COMMAND
running command...
$ agentia (--version)
@copado/agentia-cli/1.6.0 linux-x64 node-v22.23.4
$ agentia --help [COMMAND]
USAGE
  $ agentia COMMAND
...

代理检查npm rc 财务报告和审定财务报表 latest 在背景中,当安装的版本有新的版本时,警告。 自动选择使用选项 updateChannel 首选项 ~/.config/agentia-cli/config.json (单位:千美元)rc 保持双通道比较,仍安装SemVer-Greater稳定; latest 仅稳定。 在没有偏好的情况下,预放装置会比较两个标记,并选择最新的SemVer,而稳定安装则只比较 latest运行 agentia update 安装选中的发布( 一个交互的 RC- 从稳定到稳定的交叉可以提示一次保存首选项; 在成功安装后警告运行 setup skills update 在使用Agtia管理技能的每个项目中, agentia update --check 在不更改安装或偏好的情况下检查,或 agentia update --channel rc|latest 以强制安装频道并保存该首选项。 RC是支持的预释通道;稳定的出版物使用npm的 latest dis.

在调用网关支持的命令前存储网关证书 :

$ agentia auth set --cicd <api-key> --region na
$ agentia auth get

在代理服务器后使用 Agricia

Agentia在每次出局的HTTP(S)请求和CRT浏览器WebSocket连接上尊重标准代理环境变量,类似于Slesforce CLI:

• HTTPS_PROXY 编号 : https_proxy tLS 流量( 建议)
• HTTP_PROXY 编号 : http_proxy 用于普通 HTTP
• NO_PROXY 编号 : no_proxy 用于必须直接连接的主机( comma- 分离; 支持) * 后缀通配符)
• npm 风格 npm_config_https_proxy, (中文(简体) ), npm_config_proxy,以及 npm_config_no_proxy 当 CLI 在 npm 下运行时

循环目标localhost, (中文(简体) ), 127.0.0.1, (中文(简体) ), ::1)总是绕过代理,所以本地网关开发与IDE的收听者保持直接.

$ export HTTPS_PROXY=http://proxy.example.com:3128
$ export NO_PROXY=localhost,127.0.0.1,.mycompany.com
$ agentia cicd project list

公司TLS检查可能需要信任你的组织CA. 设定 NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem,或使用 NODE_USE_SYSTEM_CA=1 在支持的节点版本上.

对于 Cursor 或 Claude 代码 MCP, 在 MCP 服务器中通过相同的变量 env 块,所以网关工具可以继承它们.

NTLM 或 Kerberos 代理认证不构建; 使用本地转发代理服务器, 如 px 或者说 cntlm 给Agricia一个简单的HTTP代理.

读取用户故事

agentia cicd work get <id> --json 返回 CICD 网关提供的完整用户记录 result 属性。 JSON反应保留了嵌入关系 epic 财务报告和审定财务报表 feature 记录; 人类输出在编辑时呈现相同的字段组 oauthSignature。通过 --user-stories-ahead-behind 还比较了在下一个管道环境之前和之后的用户故事,当故事有管道和源环境时.

$ agentia cicd work get US-0001 --json
$ agentia cicd work get US-0001 --user-stories-ahead-behind

{
  "result": {
    "id": "a1Y000000000001EAA",
    "name": "US-0001",
    "title": "Improve deployment validation",
    "status": "Development In Progress",
    "project": "a0w000000000001AAA",
    "projectName": "Example Project",
    "pipelineId": "a0M000000000001EAA",
    "sourceEnvironment": "a0S000000000001EAA",
    "baseBranch": "main",
    "epic": {"id": "a0E000000000001EAA", "name": "EPIC-1", "title": "Example epic"},
    "feature": {"id": "aDs000000000001EAA", "title": "Example feature"}
  },
  "status": 0,
  "transactionId": "..."
}

cicd work create 财务报告和审定财务报表 cicd work update 验证 --acceptance-criteria 本地:它必须包含少于255个字符.

对于Copado AI代理,存储AI PAT和组织上下文一次,然后使用 ask 用于脚本或 chat 互动会议:

$ agentia auth set --ai <pat-token> --ai-domain robotic.copado.com --ai-org 42888
$ agentia ai agent ask --agent plan -p "Break this requirement into implementation steps"
$ agentia ai agent ask --agent knowledge -p "Summarize the available workspace guidance"
$ agentia ai agent chat --agent build --sf-org test14 --user-story US-1042

交互帮助和命令历史

用户可以在互动中直接打开实验性的多回合Copado支持对话 没有急切的 CCD 证书检查的终端 :

$ agentia help-agent
$ agentia support
$ agentia help --agent

在聊天中, Enter 提交提示和 Shift+ 输入新行.

Help Agent 请求通过 CIDC 网关为每次转弯提供新的短寿命访问, 因此无效或 缺少 CIDC 证书无法解决问题, 而不是阻止聊天打开 。 每一个请求 添加 CLI 系统消息, 将助理识别为 Agentia Headless 上的简明 Copado 专家 和本地开发者的 Copado 工具。 回复符一到就写出. 在每一个 将 CLI 更新版本、 平台、 架构、 工作空间基名、 常态化的当前来源, 主要的CLI/IDE/MCP使用量是计数的,还有三项最新消毒的命令摘要。 工具或工具时 无法确定本地对云操作流量, 系统提示询问一个简短澄清 问. 每个命令摘要可以包含命令ID,正统来源,参数,时间戳, 持续时间、状态、退出代码、 CLI 版本、 工作空间基名、 已编辑的结构化结果, 以及 最后20个综合产出项目。 后续转折还包括确定性编辑的最多摘要 6个成功的信息,有固定的每个消息和总字节限制,而不是重发 无约束聊天历史 。 它从未发送完整的20个KiB日志,原始用户代理头,完整路径,证书, 符号、会话标识、请求机构或任意的未编辑错误.

Agentia在业主-私人临时储存中最多保存了100个已消毒的执行摘要。 新记录 表示其来源为 cli, (中文(简体) ), ide,或 mcp;遗产记录可以省略. CLI 和 IDE 记录可以 包括经编辑的参数、结构化结果数据以及一个命令的、保留 最后20个 KiB 独立用于 stdout 和 stderr 。 MCP记录只包含命令ID,时间,结果, CLI 版本, 工作空间基名, 和源头—— 绝不是参数, 输出, 结果, 或错误 .

成功帮助 Agent turn coups 也存储在编辑后和每条消息切换后 4 KiB 私人临时JSONL。 此存储不恢复为以后的对话, 最多保留 100对,并采用滚动式24小时出入口. 检查命令摘要或清除两个仓库 改为:

$ agentia history list --limit 10
$ agentia history list --limit 10 --json
$ agentia history clear --yes

里面的帮助特工, /clear 只重放记忆中的对话 . agentia history clear --yes 删除 两个临时历史文件。 运行时间/ 历史命令、 交互式 AI 聊天命令和帮助代理 入口仍然被排除在命令执行历史之外;MCP呼叫添加只使用元数据的条目. 没有提供MCP帮助代理或历史读取工具.

见 交互式 AI 帮助代理 对于先决条件, 隐私的细节,限制, 和解决问题.

代理技能设置

agentia setup skills create 安装可移植 Markdown 唯一的代理技能,教授兼容代理如何使用 Agentia CID(包括元数据探索), CRT测试, AI, 和管道高级命令正确, 外加特定目标路由文物(.agents/skills/agentia/SKILL.md, (中文(简体) ), .cursor/rules/agentia.mdc,或 .claude/skills/agentia/SKILL.md) (中文(简体) ). 使用 --target agents 页:1 .agents/skills (便携式默认), --target cursor 页:1 .cursor/skills,或 --target claude 页:1 .claude/skills设置不会修改客户根 AGENTS.md。 。 。 .

$ agentia setup skills create --target agents
$ agentia setup skills create --cicd --target cursor --no-prompt
$ agentia setup skills update --ai --target agents --no-prompt

使用 update 以刷新 Agentia 管理的技能文件。 无关文件被保存,没有Agentia管理标记的现有文件不会被覆盖,除非 --force 很明显.

插件技能

安装的插件可以通过一个 agentia:contribute 钩 (参见 插件- sdk/ README. md) (中文(简体) ). 它们是第三方提示, 因此没有默认安装, 钩子只在您请求插件技能时运行: 交互式 setup skills create, (中文(简体) ), --plugin, (中文(简体) ), setup skills list,或 setup skills update 当插件技能已经安装时。 交互式 setup skills create 列出插件贡献( 无勾选) , 只安装您选择的插件; 无头运行和 --json 仅安装于 --plugin数字 :

$ agentia setup skills list
$ agentia setup skills create            # pick plugin skills in the prompt
$ agentia setup skills create --plugin @acme/agentia-plugin-release --target cursor --no-prompt
$ agentia setup skills update

以 id 身份贡献的技能 release 安装为 agentia-release。 。 。 . setup skills list 显示可安装的技能,以及为什么一个无效的插件被跳过;一个失败或慢的插件从不屏蔽其他的,一个没有钩子的插件会被忽略。 与 --plugin 并且没有只写包旗插件技能;否则生成的 Agentia 规则文件会为每个已安装的插件技能获得"Plugin 技能"一行. 插件技能带有每个插件管理的标记; 未经管理或由另一个插件拥有的文件永远不会被替换 --force。 。 。 . setup skills update 没有旗帜的插件也刷新了项目中已有的插件技能,并在插件未安装或不再贡献时警告. 除非您运行, 否则不会删除 agentia setup skills update --prune,它只删除那些带有插件所管理标记的文件(从未标记过文件、符号链接或其他插件文件),从规则文件中去掉它们的行,并被跳过,用于任何钩子失败或超时的插件。 贡献如果列出非马克当文件,符号链接,插件外的路径,则被拒绝, allowed-tools,保留或复制的 id,不支持 apiVersion,或者超过50个文件,每个文件256个KiB,或者每个技能1个MiB.

撰稿人设置、本地网关模式和集成测试记录于 发展.md。 。 。 .

本地 MCP 服务器

Agentia可以作为本地的模型上下文协议(MCP)服务器运行于stdio上. Cursor等与MCP相容的客户端然后可以在不使用终端的情况下调用Agentia工具.

先决条件

1. 安装 CLI 这样 agentia 可用时间 :

$ npm install -g @copado/agentia-cli@rc --registry https://registry.npmjs.org --@copado:registry=https://registry.npmjs.org

2. 存储证书. MCP 服务器重用与 CLI 相同的密钥链后置认证 :

$ agentia auth set --cicd <api-key> --region na
$ agentia auth set --ai <pat-token> --ai-domain robotic.copado.com --ai-org 42888
$ agentia auth get

3. 确认 MCP 命令可用 :

$ agentia mcp --help
$ agentia mcp start --help

启动服务器

$ agentia mcp start

此指相为长. 它会讲MCP 超过stdio 并等待客户端连接。 启动后不要期待交互式终端输出 .

配置光标

添加一个发射 Agentia 的 MCP 服务器条目 :

{
  "mcpServers": {
    "agentia": {
      "type": "stdio",
      "command": "agentia",
      "args": ["mcp", "start"],
      "env": {
        "AGENTIA_PROJECT_ROOT": "${workspaceFolder}"
      }
    }
  }
}

这不管用 .cursor/mcp.json 或全球 ~/.cursor/mcp.json: 光标扩展 ${workspaceFolder} 用于活动的工作空间,所以 Agentia 加载存储器的 .agentia 默认、 项目认证和 .env。保存配置后,在 Cursor 中重新装入 MCP 服务器.

配置 Claude 代码

agentia setup 可以写入工程 .mcp.json 输入 Claude 代码并预先批准 agentia 服务器在 .claude/settings.local.json。推荐条目将克劳德的项目目录通过Agricia:

{
  "mcpServers": {
    "agentia": {
      "type": "stdio",
      "command": "agentia",
      "args": ["mcp", "start"],
      "env": {
        "AGENTIA_PROJECT_ROOT": "${CLAUDE_PROJECT_DIR:-}"
      }
    }
  }
}

Claude 代码扩展 CLAUDE_PROJECT_DIR 用于本地 stdio 服务器。 若为 AGENTIA_PROJECT_ROOT 或者说 CLAUDE_PROJECT_DIR 空的或仍然是未扩展的占位符(例如) ${CLAUDE_PROJECT_DIR:-}),Agentia忽略了它,并倒回了MCP客户端所报的文件夹,再向上走去取项目标记.

您也可以手动添加 Agricia claude mcp add 或一个 mcpServers 输入 ~/.claude.json。 。 。 .

用于当地其他MCP客户,设置 AGENTIA_PROJECT_ROOT 改为绝对工程目录。 当不存在明确的根时,Agentia在可用时使用一个本地的MCP根,否则从它的启动目录上向上搜索. 需要多个本地根 AGENTIA_PROJECT_ROOT 以避免选择错误的项目.

可选最终覆盖: set AGENTIA_MCP_PROJECT_ROOT 到 MCP 服务器上的绝对工程目录 env。设定时, Agentia 使用该路径作为默认的工程根、 认证配置文件以及 .env 装入,而不使用客户端的 roots/list 项目选择结果.

请求身份

识别网关请求 什麽 跑进去了 Referer 财务报告和审定财务报表 怎么样 它跑进来了 User-Agent 财务报告和审定财务报表 event-source。 。 。 .

• 贝壳CLI: Referer 是 oclif 命令 id (例如 cicd:environment:list) (中文(简体) ). User-Agent 实值 agentia-cli/<version> 财务报告和审定财务报表 event-source 实值 agentia-cli。 。 。 .
• MCP: 将 CLI 命令包裹起来的工具, 发送与 ID 相同的命令 Referer。 。 。 . User-Agent 实值 agentia-mcp/<version> 财务报告和审定财务报表 event-source 实值 agentia-mcp。只使用 MCP 的帮助者将其 MCP 工具 ID 保留为 Referer。 。 。 .
• IDE: 设置 AGENTIA_CLIENT_ORIGIN=ide 当IDE扩展产出Agentia时,包括 agentia mcp start,并通过扩展版本为 AGENTIA_IDE_VERSION。一个有效的 IDE 版本生成 User-Agent: agentia-ide/<ide-version> (agentia-cli/<cli-version>); 缺少或无效的值返回到 agentia-ide/<cli-version>。 。 。 . event-source 遗 物 agentia-ide。不支持的源值和 IDE 版本被忽略.

可用工具

工具是JSON安全并返回结构化的结果。 敏感字段被编辑 .

通用工具说明

• agentia_work_set, (中文(简体) ), agentia_work_publish,以及 agentia_work_submit 运行在 MCP 服务器进程当前工作目录中的 Git 寄存器上. 他们可以检查一个树枝, 从,推到 origin; 从预定仓库启动服务器。 若为 agentia_work_set 返回时 status: "warning",它打印了网关消息,没有运行 git 或更新本地工作环境。 工作集抓取基分行,当该参考文献存在时,远程功能分行,然后创建或检查退出 feature/<user-story-name> 从远程特性当存在, 否则从基部。 工作集还将 Copado 故事源证书与 CIDC 项目默认在工作/设置响应后进行比较:当故事证书缺失时,它会发出警告,当绑定的故事没有项目默认时会跳过比较,当故事不同时会发出警告而不改变故事(当前证书和环境显示;使用) agentia_work_update 编号 : cicd work update --source-credential 以改变它.
• agentia_ai_ask 镜像 agentia ai agent ask --json: 它会缓冲代理响应, 返回结构化的警告/ 跟踪/ 链接, 并且永远不会返回隐藏的推理块 。 计划、构建和测试请求接受 credentialId, (中文(简体) ), forceCredentialSync,以及 noCredentialSync 以控制工程默认 Copado 证书同步,加 sfOrg 仅作为快捷的背景.
• 基于浏览器 cicd environment auth web login 仍然是只使用CLI的指令.
• 管道和工作工具需要 userId 财务报告和审定财务报表 organizationId 用于网关 x-user-id 财务报告和审定财务报表 x-organization-id 头.
• 任务列表接受诸如 status, (中文(简体) ), name, (中文(简体) ), type, (中文(简体) ), parent, (中文(简体) ), context,以及 limit。 。 。 .
• 元数据工具需要与 CLI 旗帜相同的网关标识符, 例如 pipelineId, (中文(简体) ), sourceOrgId,以及 sourceCredentialId 在适用的情况下.
• 项目列表接受可选 mine 将结果限制在目前用户拥有或相关的项目.
• 由本地或全局默认管理的项目默认工具 agentia cicd project default *。 。 。 .
• 用户获得默认值 id 改为 me 用于认证用户.
• 环境创建/更新工具映射相应的 CLI 命令, 只发送您提供的字段 .
• 工作设置/ 打印/ 提交/ done 工具镜像 CLI 工作流程 : set 准备 feature/<user-story-name>,则 publish 编号 : submit 编号 : done 在当前特征分支上运行,具有相同的清洁树和基干要求. agentia_work_push 仍为兼容性别名 agentia_work_publish。 。 。 .
• agentia_cloud_commit 需求 metadataCategory 用于简单的输入,每个 changes 需要输入 c (或 category) (中文(简体) ). 销售力量元数据集 SFDX。 Copado SFDX 部署将更改的行按该字段进行分类;省略其日志“未找到的销售量更改”并跳过部署.
• 工作部署步骤工具镜像 cicd work deployment-step *; 创建接受已解析的内置 configJson 或与 CLI 相同的特定类型引导字段,更新使用 null 以清除已失效的字段,重新排序需要完成 before 财务报告和审定财务报表 after ID阵列.
• 升级列表接受与 agentia cicd promotion list; 升迁取取升迁身份证. agentia_promotion_job_step_update 镜像 cicd promotion job-step update,验证稀有的手动任务更新,并裁剪受让人值. agentia_promotion_run 财务报告和审定财务报表 agentia_cloud_promote 重新使用CLI的飞行前,运行/恢复,命令部署步骤,以及限制投票行为. agentia_cloud_promote 并自动创建前置 Draft 推广, 当没有包含 User Story 并返回可选 createdPromotion 在结果.
• agentia_notification_configure 镜像 agentia cicd notification configure: 当前用户的管道上只使用黑字订阅. 解决管道问题 已经 agentia_pipeline_get 先说 需要所有字段pipelineId, (中文(简体) ), event, (中文(简体) ), destinationType, (中文(简体) ), destinationId, (中文(简体) ), subscription) (中文(简体) ). 带有空格的事件名称使用与 CLI 相同的下划线符号( 例如 ) Test_Not Started) (中文(简体) ).
• agentia_notification_get 镜像 agentia cicd notification get: 需要 pipelineId 返回时进行消毒 { pipelineId, subscriptions } 用于认证的用户(没有原始的系统财产元数据).

CRT 网络 Git 辅助工作

使用 Git 存储, 当 CRT 应当从仓库分支获取 Robot Framework 文件, 而不是将本地文件上传到快照工作 .

agentia testing job create \
  --project 112901 \
  --robot 123456 \
  --name "Login smoke from Git" \
  --git-url https://github.com/acme/crt-tests.git \
  --git-branch feature/login-smoke

对于私人寄存器,更喜欢CRT域证书:

agentia testing job create \
  --project 112901 \
  --robot 123456 \
  --name "Login smoke from Git" \
  --git-url http