cloudbase-agent

Deploys AG-UI compatible TypeScript agent servers on CloudBase with event streaming and tool-call orchestration.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mrpersimmon/xiao-han-studio --skill cloudbase-agent-mrpersimmon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cloudbase-agent
Source: https://github.com/mrpersimmon/xiao-han-studio/tree/main/.agents/skills/cloudbase/references/cloudbase-agent/ts
Command: npx skills add https://github.com/mrpersimmon/xiao-han-studio --skill cloudbase-agent-mrpersimmon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Builds and deploys AI agents that can stream conversations and tool calls using the AG-UI protocol on CloudBase, reducing the effort of wiring frameworks, events, and UI clients by hand.

Core Features & Use Cases

  • AG-UI Protocol Support for Streaming: Understand and implement the required event lifecycle (RUN_STARTED/RUN_FINISHED/RUN_ERROR plus TEXT_MESSAGE_* and TOOL_CALL_* patterns) for reliable UI updates.
  • Production-Oriented Agent Adapters: Use ready adapters for LangGraph and LangChain, or create custom adapters by extending AbstractAgent and returning Observable<BaseEvent>.
  • Agent Server Deployment Guidance: Deploy agent HTTP services using @cloudbase/agent-server with CloudBase best practices (Node.js 20 runtime, SSE readiness, dependency alignment, and manageAgent MCP).
  • UI Client Integration: Connect web and WeChat Mini Program UIs to the agent server endpoints using @ag-ui/client and @cloudbase/agent-ui-miniprogram.

Quick Start

Ask your coding agent to deploy a TypeScript AG-UI agent server on CloudBase using manageAgent with Node.js 20, then wire a LangGraph or LangChain adapter and confirm SSE streaming works from the /send-message endpoint.

Frequently Asked Questions about cloudbase-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a LangChain agent server on CloudBase with SSE streaming?

Deploy a TypeScript AG-UI agent server on CloudBase using @cloudbase/agent-server with Node.js 20, wire a LangChain adapter, and confirm SSE streaming works from the /send-message endpoint.

How does AG-UI protocol event lifecycle work for streaming conversations and tool calls?

The AG-UI event lifecycle uses RUN_STARTED, RUN_FINISHED, and RUN_ERROR events alongside TEXT_MESSAGE_* and TOOL_CALL_* patterns to stream agent conversations and tool call updates to UI clients reliably.

Can I use a custom AI agent framework with @cloudbase/agent-server?

Yes, you can create custom agent adapters by extending AbstractAgent and returning Observable<BaseEvent> to translate framework input/output into AG-UI compatible events for @cloudbase/agent-server.

What's the best way to connect a WeChat Mini Program UI to an AG-UI agent backend?

Connect web and WeChat Mini Program UIs to agent server endpoints using @ag-ui/client and @cloudbase/agent-ui-miniprogram to consume the SSE event streams from the deployed CloudBase agent server.

Do I need Node.js 20 to deploy AG-UI agent servers on CloudBase?

Yes, deploying AG-UI compatible agent servers on CloudBase requires the Node.js 20 runtime to ensure SSE readiness and dependency alignment for stable builds.

Why is my AG-UI agent streaming not updating the UI during tool calls?

AG-UI streaming requires correct event lifecycle implementation; missing RUN_STARTED, TOOL_CALL_* or RUN_FINISHED events disrupt UI updates and cause incomplete streaming responses.