使用 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。 - 补充角色配置、各工程位置、现有实现、允许修改的范围、真机条件和完成标准。
- 排查问题时提供错误现象、复现步骤、错误码以及业务服务端和设备端日志。
- 不要在提示词中写入
AccessKeyId、SecretKeyId、设备密钥、Token 或第三方智能体密钥;让 Agent 说明如何通过安全配置提供凭证。 - 要求 Agent 运行现有构建和测试,并验证字幕或回复音频、打断或设备事件、结束清理和再次开始会话。缺少真实设备、有效凭证或智能体配置时,应明确标记“待联调”。
需要手动查阅接入步骤时,可继续查看总体流程、AI 实时对话引擎控制台、服务端集成、设备端集成和事件协议。
提示词示例
可将以下内容作为提示词发给 Coding Agent:
text
使用 $ai-chat,在现有 TiRTC 设备工程上增加 AI 实时对话。
请先核对当前官方文档、角色配置和现有工程,再沿用当前架构完成
服务端 Token、设备会话、字幕和语音闭环。运行已有构建与测试,
并用真实设备验证可以开始、打断和结束对话。