Cloudbase Agent (TypeScript)

TypeScript SDK for deploying AI agents as HTTP services using the AG-UI protocol.

Note: This skill is for TypeScript/JavaScript projects only.

When to use this skill

Use this skill for AI agent development when you need to:

• Deploy AI agents as HTTP services with AG-UI protocol support

• Build agent backends using LangGraph or LangChain frameworks

• Create custom agent adapters implementing the AbstractAgent interface

• Understand AG-UI protocol events and message streaming

• Build web UI clients that connect to AG-UI compatible agents

• Build WeChat Mini Program UIs for AI agent interactions

Do NOT use for:

• Simple AI model calling without agent capabilities (use ai-model-* skills)

• CloudBase cloud functions (use cloud-functions skill)

• CloudRun backend services without agent features (use cloudrun-development skill)

How to use this skill (for a coding agent)

MUST READ: Read ALL docs that match your task

Before writing any code, identify which docs you need and read ALL of them. Reading only a subset leads to incomplete implementations (missing CORS, wrong adapter patterns, no UI client code).

Scenario-based reading lists

If the task asks you to... You MUST read these docs

Build a full-stack agent (backend + frontend) server-quickstart.md

• adapter doc + ui-clients.md

Deploy an agent server only server-quickstart.md

Use LangGraph for agent logic adapter-langgraph.md

• server-quickstart.md

Use LangChain for agent logic adapter-langchain.md

• server-quickstart.md

Build a custom adapter (no LangGraph/LangChain) adapter-development.md

• agui-protocol.md
• server-quickstart.md

Build a web/mini-program UI client ui-clients.md

• agui-protocol.md

Step-by-step workflow

• Identify the adapter type from the task description (LangGraph / LangChain / custom)

• Read the matching docs from the table above — read ALL listed docs, not just one

• Set up the agent server using @cloudbase/agent-server — always include cors: true

• Implement the agent logic using the chosen adapter

• If building UI, read ui-clients.md and create the client code

Reference doc index

Doc When to read

server-quickstart Always — deployment, CORS, logging, endpoints

adapter-langgraph Task mentions LangGraph, StateGraph, or graph-based workflows

adapter-langchain Task mentions LangChain, chains, or chain-based patterns

adapter-development Task requires custom adapter (no existing framework adapter)

agui-protocol Task requires custom adapter or deep protocol understanding

ui-clients Task mentions web UI, frontend, client, or SSE streaming

ui-miniprogram Task mentions WeChat Mini Program or miniprogram UI

Quick Start

import { run } from "@cloudbase/agent-server"; import { LanggraphAgent } from "@cloudbase/agent-adapter-langgraph";

run({ createAgent: () => ({ agent: new LanggraphAgent({ workflow }) }), port: 9000, });