§09 配置与部署：wrangler.jsonc 与全球网络

{
  "name": "my-agent-app",
  "main": "src/server.ts",
  "compatibility_date": "2025-01-01",
  "compatibility_flags": ["nodejs_compat"],   // 必需！

  "durable_objects": {
    "bindings": [
      { "name": "Counter", "class_name": "Counter" },
      { "name": "ChatAgent", "class_name": "ChatAgent" }
    ]
  },
  "migrations": [{ "tag": "v1", "new_sqlite_classes": ["Counter", "ChatAgent"] }],

  "ai": { "binding": "AI" },
  "vars": { "API_BASE_URL": "https://api.example.com" }
}

"durable_objects": {
  "bindings": [
    { "name": "Counter", "class_name": "Counter" },
    { "name": "ChatRoom", "class_name": "ChatRoom" }
  ]
},
"migrations": [{ "tag": "v1", "new_sqlite_classes": ["Counter", "ChatRoom"] }]

"migrations": [
  { "tag": "v1", "new_sqlite_classes": ["OldName"] },
  { "tag": "v2", "renamed_classes": [{ "from": "OldName", "to": "NewName" }] },
  { "tag": "v3", "deleted_classes": ["AgentToDelete"] }
]

npm run deploy

const agent = await getAgentByName(env.MyAgent, "instance", {
  locationHint: "enam", // wnam|enam|sam|apac ...
});