mcpField
A
alicloud-ai-chatbot

alicloud-ai-chatbot

github.com/cinience云与 DevOps396279 次安装11 周前更新
代码仓库

关于 alicloud-ai-chatbot

通过 OpenAPI 管理 Alibaba Cloud Chatbot（beebot）资源的技能。它以 API 发现为起点，涵盖资源查询、变更和状态检查，适用于资源管理与故障排查。

主要功能

  1. 01通过 OpenAPI 管理 beebot 资源
  2. 02发现 API 操作及参数
  3. 03列出并检查资源
  4. 04创建或更新配置
  5. 05查询状态以便排查问题

适用场景

  1. 01发现可用的 Chatbot API
  2. 02检查现有 Chatbot 资源
  3. 03变更资源配置
  4. 04排查时检查服务状态

MCP 相关

输入未说明 MCP 集成，也未描述 MCP 接口。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-ai-chatbot

安装后在 Claude Code 中输入/alicloud-ai-chatbot确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
sources.md
scripts/
list_openapi_meta_apis.py

详细介绍

类别：服务

聊天机器人（beebot）

使用 Alibaba Cloud OpenAPI（RPC）及官方 SDK 或 OpenAPI Explorer 管理 beebot 资源。

工作流

  1. 确认地域、资源标识符和所需操作。
  2. 查找 API 列表和必需参数（参见参考资料）。
  3. 使用 SDK 或 OpenAPI Explorer 调用 API。
  4. 使用 describe/list API 验证结果。

AccessKey 优先级（必须遵守）

  1. 环境变量：ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID 地域策略：ALICLOUD_REGION_ID 是可选的默认值。如果未设置，请为任务选择最合适的地域；如果不明确，请询问用户。
  2. 共享配置文件：~/.alibabacloud/credentials

API 查找

  • 产品代码：Chatbot
  • 默认 API 版本：2022-04-08
  • 使用 OpenAPI 元数据端点列出 API 并获取架构（参见参考资料）。

高频操作模式

  1. 资源清单/列表：优先使用 List* / Describe* API 获取当前资源。
  2. 更改/配置：优先使用 Create* / Update* / Modify* / Set* API 执行变更。
  3. 状态/故障排查：优先使用 Get* / Query* / Describe*Status API 进行诊断。

最简可执行快速入门

调用业务 API 前，先查找元数据：

python scripts/list_openapi_meta_apis.py

可选覆盖项：

python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>

脚本会在 skill 输出目录下写入 API 清单文件。

输出策略

如果需要保存响应或生成的文件，请将其写入： output/alicloud-ai-chatbot/

验证

mkdir -p output/alicloud-ai-chatbot
for f in skills/ai/service/alicloud-ai-chatbot/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-ai-chatbot/validate.txt

通过标准：命令以状态码 0 退出，并生成 output/alicloud-ai-chatbot/validate.txt。

输出与证据

  • 将文件、命令输出和 API 响应摘要保存到 output/alicloud-ai-chatbot/ 下。
  • 在证据文件中包含关键参数（地域/资源 ID/时间范围），以便复现。

前提条件

  • 执行前配置遵循最小权限原则的 Alibaba Cloud 凭据。
  • 优先使用环境变量：ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET，以及可选的 ALICLOUD_REGION_ID。
  • 如果地域不明确，请在执行变更操作前询问用户。

参考资料

  • 来源：references/sources.md

评论

支持 Markdown