Cloudflare Computer 现可帮助 Agent 从中断中恢复并等待审批
@cloudflare/computer ↗ 为您的 Agent 提供一个运行代码的工作区。从 v0.7.0 起,这些代码可以在部署或崩溃后恢复运行,并可在外部操作(例如审批工具调用)上暂停。
在 WorkerJavaScriptBackend 或单次运行上设置 onInterrupt: "replay"。
import { DurableObject } from "cloudflare:workers";
import { Workspace } from "@cloudflare/computer";
import { WorkerJavaScriptBackend } from "@cloudflare/computer/backends/worker-javascript";
export class MyAgent extends DurableObject {
workspace = new Workspace({
storage: this.ctx.storage,
backends: [
new WorkerJavaScriptBackend({
loader: this.env.LOADER,
onInterrupt: "replay",
}),
],
});
}import { DurableObject } from "cloudflare:workers";
import { Workspace } from "@cloudflare/computer";
import { WorkerJavaScriptBackend } from "@cloudflare/computer/backends/worker-javascript";
export class MyAgent extends DurableObject<Env> {
workspace = new Workspace({
storage: this.ctx.storage,
backends: [
new WorkerJavaScriptBackend({
loader: this.env.LOADER,
onInterrupt: "replay",
}),
],
});
}触发恢复时,JavaScript 会从头重新运行,对已完成的调用复用已记录的结果,且不会再次打印先前已记录的输出。如果某个调用的结果在中断前未被记录,恢复时可能会重复执行该调用,即使其操作已经成功。有关重试处理(包括针对无法安全重复的操作使用 unsafeToRepeat()),请参阅不得运行两次的调用。
恢复会在下一次调用 workspace.runtime 时开始。若要在不等待流量的情况下恢复,请从 Durable Object 警报(alarm)中调用 workspace.runtime.recover()。
通过自定义模块公开您的应用程序函数。函数可以调用 ctx.interrupt() 暂停运行,直到您的应用程序提供审批决定。
例如,若要提供一个 GitHub 模块,允许 Agent 在获得审批后对 issue 发布评论,postComment 的实现可以如下所示:
new WorkerJavaScriptBackend({
loader: this.env.LOADER,
onInterrupt: "replay",
modules: {
// The agent's code imports this with `import { postComment } from "ws:github"`.
"ws:github": {
postComment: async ([issue, body], ctx) => {
const { approved } = await ctx.interrupt({
issue,
body,
});
if (!approved) throw new Error("The comment was rejected.");
return github.comment(issue, body, { idempotencyKey: ctx.callId });
},
},
},
});new WorkerJavaScriptBackend({
loader: this.env.LOADER,
onInterrupt: "replay",
modules: {
// The agent's code imports this with `import { postComment } from "ws:github"`.
"ws:github": {
postComment: async ([issue, body], ctx) => {
const { approved } = await ctx.interrupt<{ approved: boolean }>({
issue,
body,
});
if (!approved) throw new Error("The comment was rejected.");
return github.comment(issue, body, { idempotencyKey: ctx.callId });
},
},
},
});当 Agent 的代码调用 postComment() 时,运行会在 ctx.interrupt() 处暂停,直到您的应用作出响应。Agent 的代码像调用其他任何函数一样调用它:
import { postComment } from "ws:github";
export default async function ({ issue }) {
return postComment(issue, "Hello world");
}等待所花费的时间不计入其超时时间。等待状态在部署后也会保留。使用 workspace.runtime.pending() 获取待处理的调用,并使用 respond() 处理它们:
for (const call of await workspace.runtime.pending()) {
await workspace.runtime.respond(call.id, call.callId, { approved: true });
}for (const call of await workspace.runtime.pending()) {
await workspace.runtime.respond(call.id, call.callId, { approved: true });
}所有待处理的调用都处理完毕后,运行将继续。
有关设置方法、当前限制以及重放的工作原理,请参阅重启后恢复运行。