cloudbase-agent-ts

Cloudbase Agent (TypeScript)

AG-UI プロトコルを使用して、AI エージェントを HTTP サービスとしてデプロイするための TypeScript SDK です。

注: このスキルは TypeScript/JavaScript プロジェクト専用です。

このスキルを使用する場合

AI エージェント開発で、次のことが必要な場合にこのスキルを使用してください。

• AG-UI プロトコルに対応した HTTP サービスとして AI エージェントをデプロイする
• LangGraph または LangChain フレームワークを使用してエージェントのバックエンドを構築する
• AbstractAgent インターフェースを実装するカスタムエージェントアダプターを作成する
• AG-UI プロトコルのイベントとメッセージストリーミングを理解する
• AG-UI 互換エージェントに接続する Web UI クライアントを構築する
• AI エージェントとのやり取り用に WeChat ミニプログラムの UI を構築する

以下には使用しないでください。

• エージェント機能のない、シンプルな AI モデル呼び出し（ai-model-* スキルを使用してください）
• CloudBase クラウド関数（cloud-functions スキルを使用してください）
• エージェント機能のない CloudRun バックエンドサービス（cloudrun-development スキルを使用してください）

このスキルの使い方（コーディングエージェント向け）

必ず読む：タスクに該当するドキュメントをすべて読む

コードを書く前に、必要なドキュメントを特定し、すべて読んでください。一部だけ読むと、実装が不完全になります（CORS の不足、不適切なアダプターパターン、UI クライアントコードの欠落など）。

シナリオ別のドキュメント一覧

タスクの内容	必ず読むドキュメント
フルスタックエージェントを構築する（バックエンド＋フロントエンド）	server-quickstart.md ＋ アダプターのドキュメント ＋ ui-clients.md
エージェントサーバーのみをデプロイする	server-quickstart.md
エージェントのロジックに LangGraph を使用する	adapter-langgraph.md ＋ server-quickstart.md
エージェントのロジックに LangChain を使用する	adapter-langchain.md ＋ server-quickstart.md
カスタムアダプターを構築する（LangGraph／LangChain なし）	adapter-development.md ＋ agui-protocol.md ＋ server-quickstart.md
Web／ミニプログラムの UI クライアントを構築する	ui-clients.md ＋ agui-protocol.md

ステップごとのワークフロー

1. タスクの説明からアダプターの種類を特定します（LangGraph／LangChain／カスタム）
2. 上の表にある該当ドキュメントを読みます。1 つだけでなく、記載されたドキュメントをすべて読んでください
3. @cloudbase/agent-server を使用してエージェントサーバーをセットアップします。必ず cors: true を含めてください
4. 選択したアダプターを使用してエージェントのロジックを実装します
5. UI を構築する場合は、ui-clients.md を読み、クライアントコードを作成します

参考ドキュメント一覧

ドキュメント	読むタイミング
server-quickstart	常に — デプロイ、CORS、ログ記録、エンドポイント
adapter-langgraph	タスクに LangGraph、StateGraph、またはグラフベースのワークフローが含まれる場合
adapter-langchain	タスクに LangChain、チェーン、またはチェーンベースのパターンが含まれる場合
adapter-development	タスクでカスタムアダプターが必要な場合（既存のフレームワークアダプターがない場合）
agui-protocol	タスクでカスタムアダプター、またはプロトコルの深い理解が必要な場合
ui-clients	タスクに Web UI、フロントエンド、クライアント、または SSE ストリーミングが含まれる場合
ui-miniprogram	タスクに WeChat ミニプログラム、またはミニプログラム UI が含まれる場合

クイックスタート

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

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