跳转到内容
Tier0 Docs文档

用 Agents 操作 Tier0

适用版本EdgeCloudEnterprise

Tier0 提供 Skills 和 CLI 命令，让 AI agents 可以操作平台。

使用你偏好的 AI agent 操作 Tier0。
Claude Code
Codex
Gemini CLI
Cursor
GitHub Copilot

安装 Skills 和 CLI

Section titled “安装 Skills 和 CLI”

请选择与你的环境匹配的安装方式。

有 Node.js

Section titled “有 Node.js”

如果环境中有 Node.js 16 或更高版本，可以使用 npx 安装 CLI 和 skills。

Terminal window
npx -y @tier0/cli@latest install

该命令会运行完整安装器，并完成两件事：

  • 将 tier0 CLI binary 安装到 ~/.tier0/bin/。
  • 安装内置的 Tier0 Skill 基线，并同步到检测到的 agents，例如 Codex、Claude Code 等。

没有 Node.js

Section titled “没有 Node.js”

  1. 安装 tier0 CLI binary。

    Terminal window
    curl -fsSL https://raw.githubusercontent.com/FREEZONEX/Tier0-cli/main/install.sh | bash

  2. 下载最新 Tier0 Skills，并同步到检测到的 agents。

    Terminal window
    tier0 skills update

  3. 验证已安装的 Skill 版本和健康状态。

    Terminal window
    tier0 skills status

管理 Skills

Section titled “管理 Skills”
  • 检查已安装 Skill 的版本和健康状态：
    Terminal window
    tier0 skills status
  • 修复缺失或损坏的内置 Skill 基线：
    Terminal window
    tier0 skills install
  • 更新到最新 Tier0 Skill：
    Terminal window
    tier0 skills update

Skills 和 CLI 如何协作

Section titled “Skills 和 CLI 如何协作”

Tier0 CLI 提供可执行命令，Skills 指导 agents 选择并安全使用这些命令。

示例

Section titled “示例”
  • Prompt：检查 Plant/Line1/Metric/Temperature 的当前温度。
  • Skill
    • tier0-uns
    • 它会告诉 agent 当前值应从完整 topic path 读取，并选择合适的 UNS read 操作。
  • CLI：tier0 uns read Plant/Line1/Metric/Temperature --json

Skills

Section titled “Skills”
Skill 用途
tier0 将 Tier0 任务路由到合适的 skill，并提供共享的设置、认证和安全规则。
tier0-uns 指导 agents 执行 UNS 操作，包括 browse、read、write、history、search、create、update、delete 和 restore。
tier0-flow 指导 agents 管理 SourceFlow 和 EventFlow，包括检查、导出、创建、更新、部署和删除。
tier0-mqtt 指导 agents 管理 MQTT 凭证、发布消息，以及进行有边界的实时订阅。
tier0-files 指导 agents 执行 Tier0 文件操作，包括上传、下载、生成访问 URL 和删除。

CLI 操作

Section titled “CLI 操作”

设置操作实例

Section titled “设置操作实例”

私有化部署必须在登录前配置 base URL。配置完成后，后续所有命令都会在该实例上执行。

Terminal window
tier0 config --base-url https://your-tier0.example.com
tier0 login # interactive browser login

认证

Section titled “认证”

  1. 设置你从当前 Tier0 实例获取的 API 密钥。

    Terminal window
    tier0 config --api-key <api-key>

  2. 验证 API 密钥身份和权限。

    Terminal window
    tier0 auth whoami --json

  3. 使用 tier0 CLI 执行其他操作。

预览操作

Section titled “预览操作”

使用 --dry-run 验证并预览支持的写入操作，不向 Tier0 发送请求。

支持的操作

Section titled “支持的操作”
  • UNS：write/create/update/delete/restore
  • Flow：create/update/delete/deploy
  • API：tier0 api
  • MQTT：auth create/auth delete/publish
  • Files：delete

示例

Section titled “示例”
Terminal window
tier0 uns write --topic demo --value '{"value":1}' --dry-run
tier0 flow deploy --id 1 --flows-file flows.json --dry-run --json
tier0 api /openapi/v1/uns/write --body-file body.json --dry-run --json
tier0 mqtt auth create --name my-client --save my-client --dry-run --json
tier0 assets delete --file-path workspace/path/to/file.csv --dry-run --json

返回的预览

Section titled “返回的预览”
Terminal window
{
  "ok": true,
  "dry_run": true,
  "data": {
    "api": [
      {"method": "POST", "url": "https://tier0.dev/openapi/v1/uns/write", "body": {}}
    ]
  }
}

处理错误

Section titled “处理错误”

使用 --json 时，命令失败会返回包含错误消息和错误代码的 JSON object。

Terminal window
{"ok":false,"error":{"type":"validation","subtype":"invalid_argument","param":"--qos","message":"--qos must be 0, 1, or 2"}}

卸载 Skills 和 CLI

Section titled “卸载 Skills 和 CLI”
  • 卸载命令
Terminal window
# 移除 Tier0 CLI，但保留本地配置和 skills。
npx @tier0/cli@latest uninstall


# 移除 Tier0 CLI，并删除本地配置、凭证和缓存，但保留 skills。
npx @tier0/cli@latest uninstall --purge


# 移除 skills
npx @tier0/cli@latest uninstall --remove-skills


# 移除以上所有内容
npx @tier0/cli@latest uninstall --purge --remove-skills
  • 全局 NPM 卸载
Terminal window
npm uninstall -g @tier0/cli
  • 手动清理
Terminal window
rm -rf ~/.tier0/bin/tier0 ~/.tier0/skills
npx -y --package=skills -- skills remove tier0 -y -g

CLI 参考

Section titled “CLI 参考”

Tier0 CLI 参考 列出了全部 CLI 命令。

下一步

Section titled “下一步”