# admin-api-pixiu 操作指南

安装 Skill 后，在对话中按下面的步骤操作。

## 测试环境

### 1. 配置 hosts

在运行 Skill 的机器上，将以下记录加入 hosts（macOS/Linux：`/etc/hosts`）：

```text
47.117.64.60   user-manage-center.qmniu.com
```

其他 OA 登录域名按[测试 hosts 配置](references/test-environments.md#1-准备-oa-测试登录)添加。使用代理时，也将该域名指向上述测试 IP。

### 2. 初始化并登录

在对话中发送：

```text
使用 admin-api-pixiu，帮我初始化七小猫 test-5 的调用环境，并同步接口。
```

按照提示，在打开的浏览器中完成平台登录和测试 OA 授权。已登录时可复用现有会话。

### 3. 调用接口

```text
使用 admin-api-pixiu，查询七小猫 test-5 的广告位列表，返回前 10 条。
```

调用七猫广告后台时，把“七小猫”改成“七猫广告”；切换环境时明确写出 `test-1` 至 `test-5` 或 `dev-1`、`dev-2`。

需要新接口时发送：

```text
刷新七小猫测试环境的接口规范和缓存，再列出可用的 IAM 管理接口。
```

## 生产环境

### 1. 配置生产 Bot

登录 [QM Apps](https://apps.qmniu.com)，配置对应后台的托管 Bot 连接。凭据填写在平台配置页面，不发送到聊天中。

在对应生产后台，为 Bot 绑定角色，并给该角色勾选需要调用的接口权限；没有操作权限时联系后台管理员处理。

### 2. 初始化并登录

在对话中发送：

```text
使用 admin-api-pixiu，帮我初始化七小猫生产环境的调用配置，并同步接口。
```

按照提示完成 QM Apps 平台登录。

### 3. 调用接口

```text
使用 admin-api-pixiu，查询七小猫生产环境的广告位列表，返回前 10 条。
```

调用七猫广告后台时，把“七小猫”改成“七猫广告”。生产写操作先让 Agent 展示目标、参数和影响，确认后再执行。
