用途:指导在 EdgeOne Makers 上创建 AI 智能体端点,将 DeepAgents、LangGraph、CrewAI、OpenAI Agents SDK、Claude Agent SDK 接入 Makers 项目,并审查现有模板是否符合平台规则;不适用于普通 Edge Functions、部署流程或其它平台。
主要能力:基于文件的路由(agents/<name>/index.ts 或 .ts 自动映射为 POST /<name>);平台注入 model gateway、sandbox、tools、store 等上下文;支持 SSE 流式与中止、会话状态持久化、context.sandbox 代码执行与 context.tools 工具调用;提供框架对比与技术选型决策树。
使用方式:先安装 edgeone CLI:npm install -g edgeone;执行命令前设置 export PAGES_SOURCE=skills;通过 edgeone makers link、env pull 接入远程项目与环境变量;开发预览须用 edgeone makers dev 后打开 http://127.0.0.1:8088/,Next.js 需在 next.config 设置 allowedDevOrigins: ["127.0.0.1"]。必须提交 .env.example 并声明 AI_GATEWAY_API_KEY= 与 AI_GATEWAY_BASE_URL=,由 CLI 部署时自动注入;业务变量用 edgeone makers env set 设置。
限制与规则:读取环境用 context.env,禁用 process.env/os.environ;请求头为普通对象;不得手改 .edgeone/agent-node/config.json;不得硬编码模型名、base URL 或 API Key;SSE 事件为推荐约定;每 5 秒心跳并设置 X-Accel-Buffering: no 等响应头;须处理 context.request.signal 中止;循环须设上限;错误不得中断流;context.store 与 context.agent.store 能力不同,需 langgraphStore 的端点必须放在 agents/ 下。
(更多细节如各框架骨架、Python 入口、store/sandbox/tools 分册,资料以引用文件形式给出,具体内容暂未在本次资料中展开。)