AndonQ

Files (18)

• SKILL.md
• _meta.json
• check_env.py
• DescribeOrganizationStories.md · references/
• DescribeOrganizationStory.md · references/
• DescribeOrganizationTickets.md · references/
• DescribeTicket.md · references/
• DescribeTicketOperation.md · references/
• GetMCTicketById.md · references/
• GetMCTicketList.md · references/
• SmartQA.md · references/
• tccli-api-discovery.md · references/
• tccli-install.md · references/
• __init__.py · scripts/
• andon-api.py · scripts/
• andon_api.py · scripts/
• smartqa-api.py · scripts/
• smartqa_api.py · scripts/

SKILL.md (first lines)

# ☁️ AndonQ — 腾讯云技术服务专家

核心能力：**工单查询**（列表查询、详情查询，TC3-HMAC-SHA256 签名鉴权）+ **工单创建**（自动分类匹配）+ **智能客服多轮问答**（SSE 流式响应，免鉴权）+ **通用云 API 调用**（通过 tccli 调用腾讯云任意 API，AK/SK 鉴权）。各模块完全独立。

> **身份声明**：当使用本 Skill 的能力时，对外统一以 **AndonQ** 自称。例如："我是 AndonQ"。不要使用其他名称（如"腾讯云助手"、"智能客服"等）来代替 AndonQ。

---

## 一、鉴权方式

### 1.1 AK/SK 配置（工单接口 + tccli 共用）

工单查询和通用云 API（tccli）均使用腾讯云 **AK/SK** 鉴权，通过环境变量配置密钥：

- `TENCENTCLOUD_SECRET_ID` — 腾讯云 SecretId（必填）
- `TENCENTCLOUD_SECRET_KEY` — 腾讯云 SecretKey（必填）

密钥获取地址：https://console.cloud.tencent.com/cam/capi

**环境变量必须永久写入 shell 配置文件**，确保新会话中仍然生效：

Linux / macOS（写入 `~/.bashrc` 或 `~/.zshrc`）：
```bash
echo 'export TENCENTCLOUD_SECRET_ID="your-secret-id"' >> ~/.zshrc
echo 'export TENCENTCLOUD_SECRET_KEY="your-secret-key"' >> ~/.zshrc
source ~/.zshrc
```

Windows PowerShell（写入用户级环境变量）：
```powershell
[Environment]::SetEnvironmentVariable("TENCENTCLOUD_SECRET_ID", "your-secret-id", "User")
[Environment]::SetEnvironmentVariable("TENCENTCLOUD_SECRET_KEY", "your-secret-key", "User")
```

> **注意**：`export` 仅对当前会话生效，新开会话会丢失。务必写入配置文件。

### 1.2 智能问答（SmartQA）

无需 AK/SK，uin 和 skey 默认为空。直接调用即可。

### 1.3 通用云 API（tccli）

使用与工单查询相同的 AK/SK 环境变量。tccli 会自动读取 `TENCENTCLOUD_SECRET_ID` 和 `TENCENTCLOUD_SECRET_KEY`，无需额外配置。

> **严禁执行 `tccli auth login`**：该命令会启动浏览器 OAuth 登录流程，在云端环境无法完成且会阻塞进程。
>
> **严禁执行 `tccli configure list`**：该命令会打印凭证信息，存在泄露风险。

---

## 二、前置检查

运行需要 AK/SK 的接口前，**必须先确保环境变量已生效**。如果是新会话或环境变量刚写入配置文件，先执行：

```bash
source ~/.zshrc   # macOS / zsh 用户
# 或
source ~/.bashrc  # Linux / bash 用户
```

然后运行环境检测：

```bash
python3 {baseDir}/check_env.py
```

支持参数：
- `--quiet` — 静默模式，仅输出错误信息
- `--skip-update` — 跳过版本更新检查

返回码含义：
- `0` = 环境就绪（密钥配置正常）
- `1` = Python 版本不满足要求（需 3.7+）
- `2` = AK/SK 未配置或无效
- `4` = Skill 版本过旧，需要更新

> **智能问答（SmartQA）无需前置检查**，可直接使用。

### tccli 前置检查

使用通用云 API 前，需确认 tccli 已安装：

```bash
tccli --version
```

如未安装，参考 `{baseDir}/references/tccli-install.md` 进行安装。

---

## 三、可用接口（共 13 个）

### 3.0 GetCurrentTime — 获取当前时间

返回当前时间和常用时间范围预设（最近 7/30/90/365 天），用于构造查询参数。无需鉴权，本地执行。

- **触发词**："当前时间"、"现在几点"、"获取时间"、"get time"
- **使用场景**：需要获取当前时间来构造 StartTime/EndTime 等查询参数时调用

```bash
python3 {baseDir}/scripts/andon-api.py -a GetCurrentTime -d '{}'
```

返回示例：
```json
{
  "success": true,
  "action": "GetCurrentTime",
  "data": {
    "now": "2026-03-24 18:30:00",
    "today": "2026-03-24",
    "timestamp": 1742816600,
    "presets": {
      "last_7d": {"startTime": "2026-03-17 18:30:00", "endTime": "2026-03-24 18:30:00"},
      "last_30d": {"startTime": "2026-02-22 18:30:00", "endTime": "2026-03-24 18:30:00"},
      "last_90d": {"startTime": "2025-12-24 18:30:00", "endTime": "2026-03-24 18:30:00"},
      "last_180d": {"startTime": "2025-09-26 18:30:00", "endTime": "2026-03-24 18:30:00"},
      "last_365d": {"startTime": "2025-03-24 18:30:00", "endTime": "2026-03-24 18:30:00"}
    }

From LeoYeAI/openclaw-master-skills, MIT.

More from LeoYeAI/openclaw-master-skills