Skip to content

[Agents, Workers AI, AI Gateway] createAI, and move docs off workers-ai-provider and ai-gateway-provider - #34300

Merged
mattzcarey merged 13 commits into
productionfrom
docs/agents-models-run-and-resume
Oct 21, 2026
Merged

mattzcarey merged 13 commits into
productionfrom
docs/agents-models-run-and-resume

Conversation

@mattzcarey

@mattzcarey mattzcarey commented Oct 14, 2026 •

Copy link
Copy Markdown
Member

Documents createAI, the Agents SDK's model provider for the AI SDK and Pi AI, and moves the docs off workers-ai-provider and ai-gateway-provider, which are now deprecated on npm. Everything here shipped in agents 0.29.0.

  • Models pages (/agents/models/, AI SDK, Pi AI) and the OpenCode and Pi harness pages: catalog ids, dynamic routes, vendor model objects on the provider-native endpoint, the account id and API token form, byokAlias / zdr / vendorKey, stream resume, and Nova-3 transcription.
  • Workers AI and AI Gateway: workers-ai/configuration/ai-sdk and ai-gateway/integrations/vercel-ai-sdk are rewritten as short createAI pages, and each gets a new Pi AI sibling (workers-ai/configuration/pi-ai, ai-gateway/integrations/pi-ai). The AI SDK tab of the code selector on ai-gateway/usage/chat-completion uses createAI, and its models are current (gpt-6-luna, claude-opus-5-5, gemini-4-argon, grok-4.7).
  • 22 other pages (Agents, Think, Sandbox, Agent Memory, AI Search) swap createWorkersAI for createAI.
  • One changelog entry that leads with createAI and says both old packages are feature frozen and deprecated.

Three pages stay on the old package because they're on AI SDK v6 and createAI needs v7: ai-search/agent-sdks/ai-sdk and ai-search/how-to/human-in-the-loop-knowledge-base (ai-search-provider needs v6), and sandbox/sdk/tutorials/workers-ai-code-interpreter (follows a template pinned to v6).

The npm deprecation notices link to /agents/models/ai-sdk/, which this adds. Replaces #34482.

@mattzcarey
mattzcarey requested review from a team, irvinebroque and rita3ko as code owners October 14, 2026 13:33
@github-actions github-actions Bot added product:changelog product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. labels Oct 14, 2026
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed 408b709 · 1 finding · incremental

👉 Fix in your agent 👈
Fix the following review findings in PR #34300 (https://github.com/cloudflare/cloudflare-docs/pull/34300).

Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification.
- If you disagree, explain why.
- If you need clarification before deciding, ask those questions.
- Then share your plan for which issues to tackle and in what order.

After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.

The comment must come before the commit because the next review reads PR comments.

## Style Guide
- S-1050f7eb | src/content/changelog/agents/2026-10-21-createai.mdx:15 | Remove `please` from prose
  The style guide forbids `please` in prose. This sentence is outside a code block or backtick span: "Please migrate at your convenience."

Style Guide

Skipped: no new docs content changes since the last review.

  • src/content/changelog/agents/2026-10-21-createai.mdx:15 · Remove please from prose

    The style guide forbids please in prose. This sentence is outside a code block or backtick span: "Please migrate at your convenience."

Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://docs-agents-models-run-and-resume.previews.developers.cloudflare.com (commit 408b709)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://9a1f8ed4.previews.developers.cloudflare.com 408b709 2026-10-21T07:38:53.987Z Visit the dashboard ↗
  • Build: In progress 🔵

View logs ↗
64eab20 2026-10-21T07:27:39.824Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://d69840fd.previews.developers.cloudflare.com ff41481 2026-10-20T21:54:35.674Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://891f9143.previews.developers.cloudflare.com b525ee3 2026-10-20T15:11:43.294Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://bc6c0357.previews.developers.cloudflare.com 43116c7 2026-10-20T13:27:44.325Z Visit the dashboard ↗
  • Build: Failed ❌

View logs ↗
7b8a031 2026-10-16T21:27:06.550Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://5e355c64.previews.developers.cloudflare.com eb270e3 2026-10-14T16:49:09.362Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://64bbfd1d.previews.developers.cloudflare.com 0c9acc2 2026-10-14T16:20:19.865Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://24d62b22.previews.developers.cloudflare.com 969f2cb 2026-10-14T13:50:32.207Z Visit the dashboard ↗

@github-actions

github-actions Bot commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

Worker Preview URL: https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com
Worker Preview Deployment URL: https://b36333fe.previews.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/agents/models/ai-sdk/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/agents/models/ai-sdk/
https://developers.cloudflare.com/workers-ai/configuration/ai-sdk/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/workers-ai/configuration/ai-sdk/
https://developers.cloudflare.com/ai-gateway/integrations/pi-ai/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/ai-gateway/integrations/pi-ai/
https://developers.cloudflare.com/ai-gateway/integrations/vercel-ai-sdk/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/ai-gateway/integrations/vercel-ai-sdk/
https://developers.cloudflare.com/workers-ai/configuration/pi-ai/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/workers-ai/configuration/pi-ai/
https://developers.cloudflare.com/agents/models/pi-ai/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/agents/models/pi-ai/
https://developers.cloudflare.com/changelog/post/2026-10-21-createai/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/changelog/post/2026-10-21-createai/
https://developers.cloudflare.com/agents/models/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/agents/models/
https://developers.cloudflare.com/agents/communication-channels/chat/chat-agents/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/agents/communication-channels/chat/chat-agents/
https://developers.cloudflare.com/agents/harnesses/opencode/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/agents/harnesses/opencode/
https://developers.cloudflare.com/agents/concepts/calling-llms/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/agents/concepts/calling-llms/
https://developers.cloudflare.com/agents/runtime/operations/using-ai-models/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/agents/runtime/operations/using-ai-models/
https://developers.cloudflare.com/agents/examples/browser-agent/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/agents/examples/browser-agent/
https://developers.cloudflare.com/ai-search/agent-sdks/agents-sdk/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/ai-search/agent-sdks/agents-sdk/
https://developers.cloudflare.com/sandbox/get-started/build-an-ai-code-interpreter/ https://gh-docs-agents-models-run-and-resume.previews.developers.cloudflare.com/sandbox/get-started/build-an-ai-code-interpreter/

@github-actions github-actions Bot added product:ai-gateway AI Gateway: https://developers.cloudflare.com/ai-gateway/ product:workers-ai Workers AI: https://developers.cloudflare.com/workers-ai/ product:ai-search product:sandbox product:agent-memory Related to Agent Memory product labels Oct 20, 2026
@mattzcarey mattzcarey changed the title [Agents] Document createAI catalog ids, dynamic routes, provider-native model objects, and stream resume [Agents, Workers AI, AI Gateway] createAI, and move docs off workers-ai-provider and ai-gateway-provider Oct 20, 2026
Comment thread src/content/changelog/agents/2026-10-21-createai.mdx Outdated
Comment thread src/content/docs/agents/harnesses/pi/index.mdx Outdated
@mattzcarey
mattzcarey enabled auto-merge October 21, 2026 07:29
@mattzcarey
mattzcarey added this pull request to the merge queue Oct 21, 2026
Merged via the queue into production with commit 4239bd7 Oct 21, 2026
16 checks passed
@mattzcarey
mattzcarey deleted the docs/agents-models-run-and-resume branch October 21, 2026 11:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agent-memory Related to Agent Memory product product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. product:ai-gateway AI Gateway: https://developers.cloudflare.com/ai-gateway/ product:ai-search product:changelog product:sandbox product:workers-ai Workers AI: https://developers.cloudflare.com/workers-ai/ size/xl

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants