↑

CloudBase Agent SDK 语言路由v1.0.0

cloudbase-references-cloudbase-agent1 KB

在 CloudBase 平台部署 AI Agent 服务时自动选择 TypeScript 或 Python 技术栈，并加载对应语言的完整开发指南。未指定语言时默认使用 TypeScript。

0 0 0 0 更新于 2026-10-28 18:24

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 面向需要在 CloudBase 平台构建和部署 AI Agent 服务的开发者，核心作用是充当语言路由层：根据用户输入中的技术栈信号（如 "TypeScript""Node.js""Python""FastAPI" 等）自动判定使用 TypeScript 还是 Python 方案，并引导读取对应语言的详细技能文件。TypeScript 路径基于 @cloudbase/agent-server 包，Python 路径基于 cloudbase-agent-server 的 FastAPI 实现；若用户未明确指定语言，强制默认走 TypeScript 路线。每个语言子技能文件内含独立的快速开始、路由表、部署指引和 LangGraph / LangChain / CrewAI 适配器开发指南，确保代码生成前拿到完整上下文。

技能包含

  • SKILL.md（本文件）：语言判定规则与路由逻辑，强制要求先读对应语言子技能再生成代码
  • ts/skill.md：TypeScript 完整开发指南，含 @cloudbase/agent-server 快速开始、部署步骤、AG-UI 协议事件说明与适配器开发
  • py/skill.md：Python 完整开发指南，含 cloudbase-agent-server（FastAPI）快速开始、部署步骤、AG-UI 协议事件说明与适配器开发

核心能力

  • 智能语言路由：依据用户提到的技术关键词自动匹配 TypeScript 或 Python 开发路径
  • 默认策略兜底：无明确语言信号时强制回退到 TypeScript，避免决策悬停
  • 前置读取约束：代码生成前必须完成对应语言子技能文件的全文加载，防止基于不完整上下文输出
  • 双栈完整覆盖：同一套 CloudBase Agent SDK 能力，分别提供 npm 包与 PyPI 包的实现细节

应用场景

用户怎么说本技能做什么
"我要用 TypeScript 搭一个 Agent 服务"路由到 ts/skill.md，加载 Node.js 部署与 @cloudbase/agent-server 的完整指南
"Python + FastAPI 做 Agent 后端"路由到 py/skill.md，加载 pip 安装、FastAPI 部署及适配器开发流程
"CloudBase 怎么部署 AI Agent"默认走 TypeScript 路径，先加载 ts/skill.md 再进入具体实现
"LangGraph 适配器怎么写"按已判定的语言加载对应子技能中的适配器开发章节，输出该语言的具体代码结构