cloudbase-agent-ts

SKILL.md

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,
});

28:["$