---
title: 在 CLI 中使用 Investibook
order: 2
description: 三步消灭告警噪音。
---

# 在 CLI 中使用 Investibook

Investibook CLI 让你直接在终端驱动调研 —— 或者把一大堆告警丢给 agent，让它分组、诊断。

## 三步消灭告警噪音

### 1. 下载

下载 CLI 和给 agent 用的 skill bundle：

```bash
curl -fsSL "https://investibook-build.s3.amazonaws.com/install.sh" | bash
```

- [CLI release](https://github.com/tidbcloud/aiops/releases/tag/investibook%2Fcli%2Fv0.1)
- [SKILL.md](https://investibook-build.s3.amazonaws.com/SKILL.md)

### 2. 认证

在 Investibook 创建 API key，把认证信息交给 agent。

![CLI 认证步骤提示](/docs/_assets/cli-auth-step.png)

![CLI 认证详情](/docs/_assets/cli-auth-detail.png)

### 3. 发请求

直接告诉 agent 你想要什么，例如：

> 这里有一大批告警，请帮我归类成 workspace 并诊断风险。

agent 会先把告警分组成 workspace：

![CLI 输出：agent 把告警分组成 workspace](/docs/_assets/cli-result-summary.png)

…然后逐组诊断，必要时回头问你：

![CLI 输出：逐 workspace 诊断](/docs/_assets/cli-result-diagnosis.png)

## 显式提示某些技能

可以直接告诉 agent 用哪些 skill：

```text
Use skill tidb-perf-diagnosis and skill clinic-api to help me understand
the hotspot issue in cluster xxxx
```

## 什么时候选 CLI

- 一次有大量告警，希望先批量过一遍再决定要不要打开 UI。
- 喜欢把调研留在终端里、和别的工具放在一起。
- 在编写定期跑的脚本，让它输出调研摘要。