Skip to content

[Agents] Move Chat SDK to Runtime Communication and rename Agent tools#31272

Open
thomasgauvin wants to merge 3 commits into
productionfrom
agents-restructure-chat-sdk-tools
Open

[Agents] Move Chat SDK to Runtime Communication and rename Agent tools#31272
thomasgauvin wants to merge 3 commits into
productionfrom
agents-restructure-chat-sdk-tools

Conversation

@thomasgauvin
Copy link
Copy Markdown
Contributor

Summary

Moves the Chat SDK documentation from the Runtime Execution section to the Runtime Communication section, since Chat SDK is a communication channel integration. Also renames "Agent tools" to "Agents as tools" for consistency.

  • Moved chat-sdk.mdx from /agents/runtime/execution/ to /agents/runtime/communication/
  • Renamed page title in agent-tools.mdx from "Agent tools" to "Agents as tools"
  • Updated all internal links and references across the Agents documentation
  • Updated the redirect in public/__redirects for the old Chat SDK path

Documentation checklist

@github-actions github-actions Bot added product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/m labels Jun 6, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 6, 2026

This PR requires additional review attention because it affects the following areas:

Redirects

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /agents/runtime/execution/chat-sdk/

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 6, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/public/__redirects @cloudflare/content-engineering, @cloudflare/product-owners
/src/content/docs/agents/ @irvinebroque, @rita3ko, @elithrar, @thomasgauvin, @threepointone, @whoiskatrin, @cloudflare/product-owners, @cloudflare/ai-agents, @cloudflare/dev-plat-leads

@thomasgauvin thomasgauvin marked this pull request as ready for review June 6, 2026 05:46
@cloudflare-docs-bot
Copy link
Copy Markdown
Contributor

cloudflare-docs-bot Bot commented Jun 6, 2026

Review

⏸️ Automatic reviews for this PR are paused.

This PR has already received 2 automatic reviews. To run another review, a codeowner can comment /review or /full-review.

Tip: Keep PRs in draft mode until they are ready for review — the bot skips draft PRs automatically.


✅ No style-guide issues found in commit e976017.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.

@ask-bonk ask-bonk Bot added documentation Documentation edits content:edit Request for content edits labels Jun 6, 2026
Copy link
Copy Markdown
Contributor

@ask-bonk ask-bonk Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues need attention.

CRITICAL

  • Missing redirect for the old Chat SDK direct path ().

MEDIUM

  • body text and heading still say "Agent tools" after the title was renamed to "Agents as tools". For consistency, also update lines 13, 15, 17, and 210.

Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 1 potential issue.

View 1 additional finding in Devin Review.

Open in Devin Review

Comment thread public/__redirects
Copy link
Copy Markdown
Contributor

@ask-bonk ask-bonk Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues need attention.

CRITICAL

  • Missing redirect for the old Chat SDK direct path (/agents/runtime/execution/chat-sdk/).

MEDIUM

  • agent-tools.mdx body text and heading still say "Agent tools" after the title was renamed to "Agents as tools". For consistency, also update lines 13, 15, 17, and 210.

Comment thread public/__redirects
@ask-bonk
Copy link
Copy Markdown
Contributor

ask-bonk Bot commented Jun 6, 2026

Review complete for PR #31272

Labels applied: documentation, content:edit (in addition to existing product:agents, size/m)

Issues found:

CRITICAL — Missing redirect for the moved Chat SDK page. The file moved from /agents/runtime/execution/chat-sdk/ to /agents/runtime/communication/chat-sdk/, but only the legacy /agents/api-reference/chat-sdk/ redirect was updated. Anyone with a direct bookmark to the old execution path will hit a 404. I posted an inline suggestion on public/__redirects to add:

/agents/runtime/execution/chat-sdk/ /agents/runtime/communication/chat-sdk/ 301

MEDIUM — Incomplete terminology update in agent-tools.mdx. The page title and all cross-page link text were correctly updated from "Agent tools" to "Agents as tools", but the body text and H2 heading inside the page itself still use the old term:

  • Line 13: Agent tools let one chat agent...
  • Line 15: Agent tools support...
  • Line 17: ## Agent tools vs sub-agent RPC
  • Line 210: Agent tools are normal sub-agents...

These should be updated for consistency with the new page title.

What changed correctly:

  • File move from execution/chat-sdk.mdxcommunication/chat-sdk.mdx
  • Sidebar order updated to 10
  • All internal links updated across 11 files
  • Page title for agent-tools.mdx updated
  • Redirect for legacy api-reference/chat-sdk/ path updated to new location

github run

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 6, 2026

Preview URL: https://9dab965d.preview.developers.cloudflare.com
Preview Branch URL: https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/agents/runtime/agents-api/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/runtime/agents-api/
https://developers.cloudflare.com/agents/concepts/tools/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/concepts/tools/
https://developers.cloudflare.com/agents/runtime/execution/sub-agents/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/runtime/execution/sub-agents/
https://developers.cloudflare.com/agents/communication-channels/chat/chat-agents/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/communication-channels/chat/chat-agents/
https://developers.cloudflare.com/agents/communication-channels/chat/client-sdk/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/communication-channels/chat/client-sdk/
https://developers.cloudflare.com/agents/harnesses/think/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/harnesses/think/
https://developers.cloudflare.com/agents/harnesses/think/messengers/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/harnesses/think/messengers/
https://developers.cloudflare.com/agents/harnesses/think/tools/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/harnesses/think/tools/
https://developers.cloudflare.com/agents/runtime/communication/chat-sdk/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/runtime/communication/chat-sdk/
https://developers.cloudflare.com/agents/runtime/execution/agent-tools/ https://agents-restructure-chat-sdk-tools.preview.developers.cloudflare.com/agents/runtime/execution/agent-tools/

thomasgauvin and others added 2 commits June 6, 2026 17:57
Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 6, 2026

CI run failed: build logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content:edit Request for content edits documentation Documentation edits product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants