> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nonce.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 可用工具

> 通过 AI 助手管理矿场运营的 MCP 工具列表

## 工作区

| 工具               | 说明              |
| ---------------- | --------------- |
| `ListWorkspaces` | 列出你有权限的所有工作区及角色 |

## 矿场

| 工具                       | 说明                          |
| ------------------------ | --------------------------- |
| `ListFarms`              | 列出工作区内所有矿场                  |
| `ListFarmMetricsHistory` | 矿场每日历史指标（算力、在线数、Efficiency） |
| `ListAgents`             | 列出工作区内所有 Agent（边缘设备）        |

## 矿机

| 工具                   | 说明                     |
| -------------------- | ---------------------- |
| `ListMiners`         | 矿场内所有矿机的实时状态（算力、功耗、温度） |
| `ListMinerHistory`   | 单台矿机的性能历史              |
| `ListMinerPoolDiffs` | 矿场内矿机的矿池配置变更记录         |
| `GetMinerTasks`      | 单台矿机的 Task 执行记录        |

## 搜索

| 工具                  | 说明                                      |
| ------------------- | --------------------------------------- |
| `SearchMiners`      | 按条件搜索矿机（状态、IP 段、序列号等）                   |
| `SearchAgents`      | 按条件搜索 Agent（状态、矿场）                      |
| `SearchTaskBatches` | 按条件搜索 Task Batch（Task 类型、状态、操作者类型、时间范围） |

## Task

| 工具                | 说明                       |
| ----------------- | ------------------------ |
| `ListTaskBatches` | 列出矿场的 Task Batch         |
| `GetTaskBatch`    | Task Batch 详情，含每台矿机的执行结果 |

### CreateTaskBatch（写操作）

每个 Task 类型有独立的工具和参数 schema。详见 [Task 参数](/zh/api-guide/tasks#task-parameters)。

| 工具                                        | Task Name                    | 说明          |
| ----------------------------------------- | ---------------------------- | ----------- |
| `CreateTaskBatch_MinerSystemReboot`       | `miner.system.reboot`        | 重启矿机        |
| `CreateTaskBatch_MinerLogGet`             | `miner.log.get`              | 收集矿机诊断日志    |
| `CreateTaskBatch_MinerLightUpdate`        | `miner.light.update`         | 开关矿机指示灯     |
| `CreateTaskBatch_MinerPowerModeUpdate`    | `miner.power_mode.update`    | 切换功耗模式      |
| `CreateTaskBatch_MinerFirmwareUpdate`     | `miner.firmware.update`      | 更新矿机固件      |
| `CreateTaskBatch_MinerPoolLock`           | `miner.pool.lock`            | 锁定或解锁矿池配置   |
| `CreateTaskBatch_AgentScanCreate`         | `agent.scan.create`          | 扫描网络发现矿机    |
| `CreateTaskBatch_AgentSelfUpdate`         | `agent.self.update`          | 更新 Agent 版本 |
| `CreateTaskBatch_MinerAssetUpdate`        | `miner.asset.update`         | 更新矿机资产状态    |
| `CreateTaskBatch_MinerAssetDelete`        | `miner.asset.delete`         | 标记矿机资产为已删除  |
| `CreateTaskBatch_MinerRackLocationUpdate` | `miner.rack_location.update` | 更新矿机机架位置    |