Cloudflare Agents SDK
Cloudflare's framework for building stateful, durable AI agents on Workers/Durable Obje…
Cloudflare's framework for building stateful, durable AI agents on Workers/Durable Objects (Agent class, sessions, scheduling, WebSockets, fibers, observability), the bottom layer of its 2026 agents platform. First-party Cloudflare platform investment with active 2026 releases (v0.16+), durable execution and Agent Memory; underpins Flue and Project Think. SDK adapter
Beta
Status
SDK / Library
Pattern
Node.js / TypeScript
Runtime
Not yet published
SDK version
Readiness
What “Beta” means for Cloudflare Agents SDK
The integration path is built and tested. Real customers can attach now, but expect minor breaking changes until the 1.0 contract freeze.
How it attaches
SDK / Library.
Install the @trustvice/actor-cloudflare-agents-sdk package and call witness.attach() once during agent initialisation.
Install the Trustvice adapter package from npm, PyPI, or cargo and call witness.attach(agent) in your application.
npm install @trustvice/actor-cloudflare-agents-sdk
- 1
Install the adapter
Add @trustvice/actor-cloudflare-agents-sdk to your project from npm.
- 2
Issue a workspace API key
Generate a twk_-prefixed key in the dashboard under Settings → API Keys, scoped to the workspace and environment this agent's data should land in.
- 3
Attach the witness
Call witness.attach(agent) once when you initialise your Cloudflare Agents SDK agent. The adapter registers the framework callbacks, handles retries, and performs the workspace handshake.
- 4
Verify
Trigger one agent run. The dashboard's Witness page shows the canonical record within ~1 second of the agent emitting it.
npm install @trustvice/actor-cloudflare-agents-sdk
Coverage
4 event types captured.
agent.invocationEvery top-level agent run — the input, the resolved output, timing, and token usage.
tool.callEach tool / function the agent invokes, with arguments and the returned result.
memory.writeWrites to the agent's persistent memory store, so state changes are auditable.
sub_agent.spawnSub-agents the orchestrator spawns, captured with their parent lineage.
The full pattern guide
SDK / Library — end to end.
Every framework on this pattern shares the same platform-side spine, endpoints, and gotchas. The pattern guide covers them in full.
Read the SDK / Library guideNeed help landing Cloudflare Agents SDK?
Talk to the integration team.
We help you land the integration end to end — including the parts that live in your environment.
Request integration help
Trustvice 360声明规则，让每次运行都接受检查。
智能体、证据、治理、商务和披露都在 Trustvice 360 中。免费注册，在一个仪表板中打开所有套件。