Skip to content

使用 Skills 集成

借助支持 Agent Skills 的 Coding Agent,可以更高效地完成 AI 实时对话引擎的需求分析、产品接入和跨端问题排查。配置 Tange Skills 后,Agent 可结合当前官方文档和现有工程,选择合适的实施与验收流程。

$ai-chat 主持角色配置、业务服务端、设备会话和事件处理,并在需要连接或媒体能力时使用 $tirtc。Skill 不是 SDK,也不需要单独启动。

安装 Tange Skills

使用前请准备 Node.js 22.20.0 或更高版本、Python 3.10 或更高版本和 curl,并确认:

  • 使用的开发工具支持 Agent Skills;下文以 Codex 为例。
  • 当前网络可以访问 AI 实时对话引擎与 TiRTC 官方文档、SDK 和示例下载源。

使用 Skills CLI 配置:

bash
npx --yes skills@latest add \
  https://github.com/tangeai/skills.git \
  --skill tirtc \
  --skill ai-chat \
  -g -a codex -y

-g 表示安装到当前系统用户;如果只想在当前工程中使用,请去掉 -g-a codex 指定目标 Agent,使用其他兼容工具时可替换为 Skills CLI 支持的 Agent。

完成后,请开启一个新任务或刷新 Skill 列表。

仓库地址

最新使用和更新方式以仓库 README 为准。

最佳实践

配置完成后,可直接让 Coding Agent 接入 AI 实时对话引擎或排查跨端问题。为了获得可落地、可验证的结果:

  • 明确 AI 实时对话引擎、涉及的端、目标对话流程和功能;提示词只需指定主 Skill $ai-chat,它会按需协调 $tirtc
  • 补充角色配置、各工程位置、现有实现、允许修改的范围、真机条件和完成标准。
  • 排查问题时提供错误现象、复现步骤、错误码以及业务服务端和设备端日志。
  • 不要在提示词中写入 AccessKeyIdSecretKeyId、设备密钥、Token 或第三方智能体密钥;让 Agent 说明如何通过安全配置提供凭证。
  • 要求 Agent 运行现有构建和测试,并验证字幕或回复音频、打断或设备事件、结束清理和再次开始会话。缺少真实设备、有效凭证或智能体配置时,应明确标记“待联调”。

需要手动查阅接入步骤时,可继续查看总体流程AI 实时对话引擎控制台服务端集成设备端集成事件协议

提示词示例

可将以下内容作为提示词发给 Coding Agent:

text
使用 $ai-chat,在现有 TiRTC 设备工程上增加 AI 实时对话。
请先核对当前官方文档、角色配置和现有工程,再沿用当前架构完成
服务端 Token、设备会话、字幕和语音闭环。运行已有构建与测试,
并用真实设备验证可以开始、打断和结束对话。

AI 实时对话引擎文档