dsh-agora

A DeepSeek Harness (DSH) plugin that adds the official Agora skill — with Shengwang support baked in — to your agent. One install gives you voice AI agents, RTC video/voice calls, RTM chat & signaling, Cloud Recording, Agora CLI acceleration, and server-side token generation — driven from natural language.

The skill is synced verbatim from the official AgoraIO/skills repository, so it always matches the Agora docs and quickstarts.

Prerequisites

• DeepSeek Harness (DSH) installed and running
• An Agora account (for tokens/App ID when you build a real app)

Install

dsh plugin --profile web add dsh-agora

Note: with pnpm ≥ 8.15 (e.g. 9.15) the profile workspace root rejects a bare add with ERR_PNPM_ADDING_TO_ROOT. If you hit that, pass -w:

dsh plugin --profile web add -w dsh-agora

Restart the web profile, and the agora skill appears in the skill catalog.

What the skill covers

| Area | What you can do | |---|---| | Voice AI agents (ConvoAI) | Build voice agents / voicebots | | RTC | Video & voice calls, live streaming, screen sharing | | RTM | Chat, presence, signaling | | Cloud Recording | Record calls and streams | | Server | Generate tokens & App IDs server-side | | Server Gateway | Cross-product server coordination | | Agora CLI | CLI acceleration (auto-detected if installed) |

Shengwang support

The same agora skill covers the Shengwang region (console.shengwang.cn). At release time, the plugin injects a region gate at the top of each product reference — the model confirms China vs global first — and ships a per-product CN difference map (cn.md) that the model loads only when the user targets mainland China:

| Product | CN delta | |---|---| | RTC | CN region (setArea({ areaCode: "CHINA" }) / AREA_CODE_CN) + sd-rtn.com + cloud proxy | | RTM | CN region (setArea({ areaCodes: ["CHINA"] }) / RtmAreaCode.CN) + CN data center | | Cloud Recording | api.sd-rtn.com + clientRequest.region="CN" + mainland storage | | Server (token) | token algorithm unchanged; CN REST domain + credential menu path | | Agora CLI | agora project create --region cn / --rtm-data-center CN | | ConvoAI | English quickstart skeleton + api.agora.io/cn endpoint + BYOK vendors (fengming ASR, deepseek/minimax LLM/TTS) |

The official skill content stays verbatim; the region gate and CN maps are generated at build time (see scripts/sync-deps.sh), so there is still a single agora skill — no separate companion skill.

Using the skill

Describe what you want in natural language — e.g. "set up a voice AI agent with Agora" or "build an RTC video call app". The skill routes to the official quickstarts and guides you through setup, including auth and token flows.

FAQ

Does this repo contain the skill itself? The official agora content is synced verbatim from the AgoraIO/skills repo at each release (not committed). The Shengwang deltas live in assets/agora-cn/ and are built at release time into a per-product cn.md map plus a region gate (see scripts/sync-deps.sh).

Do I need the Agora CLI installed? No. It's optional; if it's on your PATH, the skill uses it for faster workflows.

License

MIT