在Agent Space中制作自动化脚本需先部署Agent Runtime并初始化SDK,配置agent-config.yaml中runtime.host,安装v2.3.0+ SDK,编写脚本调用runPipeline(),确保Agent已注册,可添加retry或fallback逻辑,并支持批量调度与异常捕获。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Agent Space Agent中制作自动化脚本,需先确认当前环境已部署Agent Runtime服务并完成SDK初始化,否则脚本无法加载Agent实例或触发执行链。
配置Agent运行时依赖
打开项目根目录下的agent-config.yaml文件,确保runtime.host字段指向本地或远程Agent Runtime服务地址(如http://127.0.0.1:8080)。若该字段为空或格式错误,后续所有脚本调用将直接返回404连接失败。
执行npm install @agent-space/sdk安装官方SDK。注意:必须使用v2.3.0及以上版本,旧版不支持runPipeline()异步执行接口。
编写基础自动化脚本
在scripts/目录下新建auto-notify.js,粘贴以下代码:
const { AgentClient } = require('@agent-space/sdk');
const client = new AgentClient({ host: 'http://127.0.0.1:8080' });
async function main() {
const result = await client.runPipeline('alert-checker', { threshold: 85 });
console.log('执行完成:', result.id);
}
main();
这一步操作起来很简单,直接把文件保存后用node scripts/auto-notify.js运行即可。但务必确认alert-checker已在Agent Space后台注册并启用,否则会抛出AgentNotFoundError异常。
添加条件触发与重试逻辑
方法一:用内置retry选项控制失败重试
修改runPipeline()调用,加入{ retry: { maxAttempts: 3, delayMs: 2000 } }参数。Agent Runtime会在HTTP超时或5xx响应时自动重试,但【不会重试业务逻辑失败(如校验不通过)】,这类错误需由Agent自身处理。
方法二:手动判断状态并分支执行
在main()函数中追加状态检查:
if (result.status === 'FAILED') {
await client.runPipeline('fallback-handler', { originalId: result.id });
return;
}
注意:fallback-handler必须提前在Agent Space中配置好输入schema,否则第二次调用会因参数校验失败而中断。
批量调度多个Agent任务
第一步:准备任务清单
创建tasks.json,内容为数组格式,每项含agentId、input和可选delayMs字段。
第二步:读取并顺序执行
在脚本中用fs.readFileSync('tasks.json')加载,遍历数组,对每一项调用client.runPipeline(agentId, input)。若需串行等待,用await;若需并行,改用Promise.allSettled()包裹调用数组。
第三步:捕获全部异常并记录
每个runPipeline()外层包一层try/catch,将错误信息写入error.log,避免单个失败阻断整个批次。


















