Skip to content

docs(models): add DaoXE multi-protocol gateway custom endpoint example#2350

Open
seven7763 wants to merge 1 commit into
browserbase:mainfrom
seven7763:docs-daoxe-custom-endpoint
Open

docs(models): add DaoXE multi-protocol gateway custom endpoint example#2350
seven7763 wants to merge 1 commit into
browserbase:mainfrom
seven7763:docs-daoxe-custom-endpoint

Conversation

@seven7763

@seven7763 seven7763 commented Jul 13, 2026

Copy link
Copy Markdown

why

Document how to use DaoXE with Stagehand through the existing Custom Endpoints pattern (model.baseURL + account API key).

what changed

  • Add a DaoXE tab under Custom Endpoints in packages/docs/v3/configuration/models.mdx
  • Base URL: https://daoxe.com/v1
  • Model form: openai/<your-daoxe-model-id> (exact account-scoped ID from the DaoXE dashboard; no hardcoded public model list)
  • Note multi-protocol surface (OpenAI Chat Completions / Responses and Anthropic Messages); Stagehand uses the OpenAI-compatible path
  • Note service is not available in mainland China
  • Add DAOXE_API_KEY to the troubleshooting env table

DaoXE is a multi-model multi-protocol API gateway. I am a DaoXE maintainer. Examples: https://github.com/seven7763/DaoXE-AI

test plan

  • Docs page renders with the new Custom Endpoints → DaoXE tab
  • Example matches Stagehand model: { modelName, apiKey, baseURL } pattern used for OpenAI custom endpoints
  • Optional: smoke chat against https://daoxe.com/v1 with a real key + account model ID

Summary by cubic

Add a DaoXE custom endpoint example in the models docs so users can connect via an OpenAI‑compatible base URL. Also document DAOXE_API_KEY and note support for multi‑protocol gateways.

  • New Features
    • Added a DaoXE tab under Custom Endpoints with a working example using model.baseURL (https://daoxe.com/v1), modelName openai/<your-daoxe-model-id>, and DAOXE_API_KEY.
    • Clarified that Stagehand uses the OpenAI-compatible route; DaoXE also supports Anthropic Messages.
    • Updated the Custom Endpoints intro to include multi-protocol gateways, added DAOXE_API_KEY to the env table, and noted DaoXE is unavailable in mainland China.

Written for commit e9810a6. Summary will update on new commits.

Review in cubic

Document using DaoXE via Stagehand custom OpenAI-compatible baseURL
(https://daoxe.com/v1) with account-scoped model IDs and DAOXE_API_KEY.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Jul 13, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: e9810a6

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-actions

Copy link
Copy Markdown
Contributor

This PR is from an external contributor and must be approved by a stagehand team member with write access before CI can run.
Approving the latest commit mirrors it into an internal PR owned by the approver.
If new commits are pushed later, the internal PR stays open but is marked stale until someone approves the latest external commit and refreshes it.

@github-actions github-actions Bot added external-contributor Tracks PRs mirrored from external contributor forks. external-contributor:awaiting-approval Waiting for a stagehand team member to approve the latest external commit. labels Jul 13, 2026

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

No issues found across 1 file

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.
Architecture diagram
sequenceDiagram
    participant User as Stagehand User
    participant Config as Stagehand Config
    participant SDK as Stagehand SDK
    participant DaoXE as DaoXE Gateway
    participant Model as LLM Model

    Note over User,Model: Custom Endpoint Flow with DaoXE

    User->>Config: Set env: "BROWSERBASE"
    User->>Config: Set model.baseURL: "https://daoxe.com/v1"
    User->>Config: Set model.apiKey: process.env.DAOXE_API_KEY
    User->>Config: Set model.modelName: "openai/<your-daoxe-model-id>"
    
    User->>SDK: stagehand.init()
    SDK->>Config: Read model configuration
    SDK->>Config: Extract baseURL, apiKey, modelName
    
    Note over SDK,DaoXE: Stagehand uses OpenAI-compatible route
    
    SDK->>DaoXE: POST /v1/chat/completions
    DaoXE->>DaoXE: Authenticate via API key
    DaoXE->>DaoXE: Route to account-specific model
    
    alt Model available in region
        DaoXE->>Model: Forward request
        Model-->>DaoXE: Response
        DaoXE-->>SDK: OpenAI-compatible response
    else Model unavailable in China
        DaoXE-->>SDK: Error (service not available)
    end

    SDK->>SDK: Parse structured output if supported
    SDK-->>User: Return result from act/extract/observe

    Note over User,DaoXE: DAOXE_API_KEY required in .env
Loading

Re-trigger cubic

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

Labels

external-contributor:awaiting-approval Waiting for a stagehand team member to approve the latest external commit. external-contributor Tracks PRs mirrored from external contributor forks.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant