返回顶部
A

AndonQ腾讯云智能助手

AndonQ 腾讯云智能客服“领域虾” — 不切窗口、不排队,即刻获得腾讯云全产品线专业解答。支持工单查询(列表/详情/流水)、集团工单与需求单管理、腾讯云全产品线智能问答,以及通过 tccli 调用腾讯云只读查询类 API(如 CVM、CBS、CAM 等)。当用户查询工单、查看工单详情、咨询腾讯云产品问题(如 CVM、轻量应用服务器、COS 等)、查询集团工单/需求单、要求找人工客服、或需要调用腾讯云 API 查询资源信息时使用。

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.1.9
安全检测
已通过
349
下载量
免费
免费
2
收藏
概述
安装方式
版本历史

AndonQ

☁️ AndonQ — 腾讯云智能客服“领域虾”

核心能力:工单查询(列表查询、详情查询,TC3-HMAC-SHA256 签名鉴权)+ 智能客服多轮问答(SSE 流式响应,免鉴权)+ 通用云只读 API 调用(通过 tccli 调用腾讯云查询类 API,AK/SK 鉴权)。各模块完全独立。

写入类操作暂不支持:若用户要求建单、回复工单、补充说明、结单、关闭工单、确认恢复,或要求对腾讯云资源执行创建、修改、删除、启停、重启、绑定、授权等写入类动作,不要调用任何写接口或写命令,统一回复:功能规划中

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

术语同义规则事件单 = 工单。当用户说“事件单”“事件单列表”“事件单详情”“事件单流水”“事件单号”时,一律按对应的“工单”“工单列表”“工单详情”“工单流水”“工单号”理解并处理,不要额外区分两个概念

⚠️ 查询必须实时调用接口:所有查询类操作(工单列表、工单详情、工单流水、需求单列表、需求单详情、集团工单等)必须重新调用对应接口获取最新数据严禁直接总结或复述历史对话中的查询结果。即使用户之前已查询过相同内容,再次询问时仍必须重新调接口。


一、鉴权方式

1.1 AK/SK 配置(工单接口 + tccli 共用)

工单查询和通用云 API(tccli)均使用腾讯云 AK/SK 鉴权,通过环境变量配置密钥:

  • - TENCENTCLOUDSECRETID — 腾讯云 SecretId(必填)
  • TENCENTCLOUDSECRETKEY — 腾讯云 SecretKey(必填)

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

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

Linux / macOS(写入 ~/.bashrc 或 ~/.zshrc):
bash
echo export TENCENTCLOUDSECRETID=your-secret-id >> ~/.zshrc
echo export TENCENTCLOUDSECRETKEY=your-secret-key >> ~/.zshrc
source ~/.zshrc

Windows PowerShell(写入用户级环境变量):
powershell
[Environment]::SetEnvironmentVariable(TENCENTCLOUDSECRETID, your-secret-id, User)
[Environment]::SetEnvironmentVariable(TENCENTCLOUDSECRETKEY, your-secret-key, User)

注意:export 仅对当前会话生效,新开会话会丢失。务必写入配置文件。

1.2 智能问答(SmartQA)

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

1.3 通用云 API(tccli)

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

严禁执行 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}
}
},
requestId:
}

3.1 GetMCTicketList — 查询工单列表(合并)

查询当前账户下的工单列表,默认按创建时间倒序返回。后台自动合并多来源工单并按 TicketId 去重。任一来源不可用时静默忽略,不影响结果。

  • - 触发词:查询工单、工单列表、我的工单、看看工单、有哪些工单、list tickets、my tickets
  • 详细文档:使用前加载 {baseDir}/references/GetMCTicketList.md

bash

默认查询(最新 20 条)


python3 {baseDir}/scripts/andon-api.py -a GetMCTicketList -d {}

按状态过滤(待处理 + 处理中)

python3 {baseDir}/scripts/andon-api.py -a GetMCTicketList -d {StatusIdList:[0,1]}

关键词搜索

python3 {baseDir}/scripts/andon-api.py -a GetMCTicketList -d {Search:CVM,PageSize:10}

返回示例:
json
{
success: true,
action: GetMCTicketList,
data: {
tickets: [{TicketId: 202603244502, Question: CVM 无法登录, StatusId: 1}],
total: 15
},
requestId: xxx
}

工单号自动分流规则(用户只给一个工单号时)

当用户只输入一个裸工单号,没有明确说明是 MC 工单还是集团工单时,必须先按格式判断,再决定调用哪个详情接口,不要同时查询两个接口碰运气。

  • - MC 工单 ID:通常是 12 位数字且以 20 开头,例如 202604010721 → 调用 GetMCTicketById
  • 集团工单 TicketId:通常是纯数字且不符合上述 MC 格式

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 andonq-1775986641 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 andonq-1775986641 技能

通过命令行安装

skillhub install andonq-1775986641

下载

⬇ 下载 AndonQ v1.1.9(免费)

文件大小: 40.81 KB | 发布时间: 2026-4-13 09:20

v1.1.9 最新 2026-4-13 09:20
“更新描述”

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部