Skip to content

Conversation

@agents-git-bot
Copy link
Contributor

@agents-git-bot agents-git-bot bot commented Dec 21, 2025

Summary

This PR syncs documentation for changes introduced in cloudflare/agents#745, which adds comprehensive external AI provider support to the Cloudflare AI Playground.

Changes

  • Expanded AI Playground documentation (workers-ai/playground.mdx):
    • Added detailed guide for using external AI providers (OpenAI, Anthropic, Google)
    • Documented two authentication methods:
      • Provider API Key (BYOK): Use your own API key from the AI provider
      • AI Gateway (Unified Billing): Use Cloudflare credits for unified billing
    • Added configuration options documentation (system prompt, temperature, model filtering)
    • Included code export examples for all authentication modes
    • Enhanced MCP server integration guide

Related PR

Source PR: cloudflare/agents#745

Key Features Documented

  1. External Provider Support: Users can now use OpenAI (GPT-5.2, GPT-5.2 Pro, etc.), Anthropic (Claude Sonnet 4.5, Claude Opus 4.5, etc.), and Google (Gemini 3 Pro, Gemini 3 Flash, etc.) models in the Playground.

  2. Flexible Authentication:

    • BYOK mode for direct provider billing
    • AI Gateway mode for Cloudflare unified billing with centralized logging and analytics
  3. Enhanced User Experience:

    • Clear step-by-step guides for each authentication method
    • Code export functionality with working examples
    • Model filtering and configuration options

🤖 Generated with Claude Code

Sync documentation for PR #745: Add GatewayConfig and expand AI provider support

This update documents the new capability to use AI Gateway with multiple
AI providers (OpenAI, Anthropic, Google, Amazon Bedrock, Azure, and more)
when building agents. The documentation includes:

- List of 15+ supported AI providers through AI Gateway
- Example code showing how to integrate AI Gateway with different providers
- Reference to the AI Playground as a demonstration
- Benefits of routing requests through AI Gateway (logging, caching, etc.)
- Links to BYOK configuration documentation

Related PR: cloudflare/agents#745

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
@github-actions github-actions bot added size/s product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. labels Dec 21, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Dec 21, 2025

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

Pattern Owners
/src/content/docs/agents/ @irvinebroque, @rita3ko, @elithrar, @thomasgauvin, @threepointone, @whoiskatrin, @cloudflare/pcx-technical-writing, @cloudflare/ai-agents
/src/content/docs/ai-gateway/ @abhishekkankani, @palashgo, @thebongy, @roerohan, @kathayl, @mchenco, @cloudflare/pcx-technical-writing
/src/content/docs/workers-ai/ @rita3ko, @craigsdennis, @markdembo, @mchenco, @cloudflare/pcx-technical-writing

@github-actions
Copy link
Contributor

This documentation update corresponds to PR #745 in cloudflare/agents,
which adds GatewayConfig and expands AI provider support.

Changes include:
- New guide: Use external AI providers in the Playground
  - Explains how to use OpenAI, Anthropic, and Google models
  - Documents two authentication methods: Provider API Key and AI Gateway
  - Covers model selection and MCP server integration
- Updated test-remote-mcp-server.mdx to reference external provider support
- Updated ai-gateway/get-started.mdx to link to the new playground guide

These changes document the new user-facing features for testing AI
Gateway with multiple external providers through the playground interface.
@agents-git-bot agents-git-bot bot changed the title Add GatewayConfig and expand AI provider support [Automated sync] Add GatewayConfig and expand AI provider support Dec 21, 2025
- Document AI Gateway unified billing for external providers
- Add examples for OpenAI, Anthropic, and Google providers
- Explain provider API key (BYOK) vs unified billing options
- Reference ai-gateway-provider package usage

Synced from cloudflare/agents PR #745
@github-actions
Copy link
Contributor

github-actions bot commented Dec 21, 2025

CI run failed: build logs

Adds comprehensive documentation for using external AI providers (OpenAI, Anthropic, Google) in the Workers AI Playground, including:
- New guide on external provider setup and authentication
- Authentication methods: Provider API Key and AI Gateway
- Available models from each provider
- MCP server integration with external providers
- Updated test-remote-mcp-server.mdx with cross-reference

Synced from cloudflare/agents PR #745

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
@agents-git-bot
Copy link
Contributor Author

Documentation Update

Updated the PR with the following changes:

  1. Resolved merge conflict in ai-playground-external-providers.mdx by keeping the more comprehensive version from HEAD that includes:

    • Better structured content with Tabs component for authentication methods
    • More detailed "When to use" guidance for each authentication method
    • Complete model listings with descriptions for all providers
    • AI Gateway features section with links to specific documentation
  2. Fixed duplicate content in test-remote-mcp-server.mdx to avoid repetition

The documentation now comprehensively covers the new external provider support in the Workers AI Playground, including authentication options, model selection, and MCP server integration.

All changes follow the Cloudflare Style Guide requirements and Diátaxis framework principles.

This update adds detailed documentation for the Cloudflare AI Playground,
covering the new external AI provider support and authentication methods
introduced in PR #745.

Key documentation additions:
- External provider support (OpenAI, Anthropic, Google)
- Two authentication methods:
  - Provider API Key (BYOK - Bring Your Own Key)
  - AI Gateway (Unified Billing)
- Configuration options (system prompt, temperature, model filtering)
- Code export examples for all authentication modes
- MCP server integration guide

Related PR: cloudflare/agents#745

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants