Skip to content

Add warning to API-based Sandbox page about production use#475

Merged
xingyaoww merged 4 commits into
mainfrom
add-warning-api-sandbox-page
Apr 25, 2026
Merged

Add warning to API-based Sandbox page about production use#475
xingyaoww merged 4 commits into
mainfrom
add-warning-api-sandbox-page

Conversation

@xingyaoww
Copy link
Copy Markdown
Member

Summary

Adds a prominent warning to the API-based Sandbox documentation page clarifying that the Runtime API (runtime.all-hands.dev) is designed for community benchmark evaluation at scale, not for building production applications.

The warning directs users to the OpenHands Cloud Workspace for production use cases.

Context

The runtime.all-hands.dev service was built to help the community run agent benchmark evaluations at scale. It was not intended to be used as a production workspace for applications built with the SDK. This warning helps set proper expectations and guides users to the right tool for their use case.

Changes

  • Added a <Warning> component near the top of sdk/guides/agent-server/api-sandbox.mdx with a clear message about the intended use of the Runtime API and a link to the recommended alternative for production.

This PR was created by an AI agent (OpenHands) on behalf of the user.

@xingyaoww can click here to continue refining the PR

The Runtime API (runtime.all-hands.dev) was built for community benchmark
evaluation at scale, not for production applications. Add a prominent warning
directing users to use OpenHands Cloud Workspace instead when building
production applications with the SDK.

Co-authored-by: openhands <openhands@all-hands.dev>
@mintlify
Copy link
Copy Markdown

mintlify Bot commented Apr 24, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
all-hands-ai 🟢 Ready View Preview Apr 24, 2026, 11:03 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@xingyaoww xingyaoww marked this pull request as ready for review April 24, 2026 23:04
@xingyaoww xingyaoww requested a review from enyst as a code owner April 24, 2026 23:04
Comment thread sdk/guides/agent-server/api-sandbox.mdx Outdated
Comment thread sdk/guides/agent-server/api-sandbox.mdx Outdated
Copy link
Copy Markdown
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

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

Valuable addition - This warning clearly communicates the intended use case for the Runtime API and guides users to the right tool for production workloads.

[RISK ASSESSMENT]

  • [Overall PR] ⚠️ Risk Assessment: 🟢 LOW

Documentation-only change with no code or runtime behavior modifications. The warning addresses a real user need by clarifying when to use Runtime API vs. Cloud Workspace.

Note: There is one unresolved suggestion on line 9 regarding wording. Please address that before merging.

Copy link
Copy Markdown
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

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

🟡 Acceptable - Clear and valuable warning, but needs a quick grammar fix.

[RISK ASSESSMENT]

  • [Overall PR] ⚠️ Risk Assessment: 🟢 LOW

Documentation-only change with no code or runtime behavior modifications. The warning addresses a real user need by clarifying the intended use case for the Runtime API vs. production deployments.

VERDICT:
Worth merging - After fixing the grammatical error

KEY INSIGHT:
This warning prevents misuse of benchmark infrastructure for production workloads - a practical, user-focused addition.

Comment thread sdk/guides/agent-server/api-sandbox.mdx Outdated
Co-authored-by: OpenHands Bot <contact@all-hands.dev>
Copy link
Copy Markdown
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

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

🟢 Good taste - Clear and valuable warning that prevents misuse of benchmark infrastructure for production workloads.

[RISK ASSESSMENT]

  • [Overall PR] ⚠️ Risk Assessment: 🟢 LOW

Documentation-only change with no code or runtime behavior modifications. The warning addresses a real user need by clarifying the intended use case for the Runtime API vs. production deployments. Previous grammatical issues have been resolved.

VERDICT:
Worth merging - Ready to merge

KEY INSIGHT:
This warning prevents confusion about the Runtime API's purpose, guiding users to the appropriate production solution (OpenHands Cloud Workspace) when building applications with the SDK.

@xingyaoww xingyaoww merged commit 7646a67 into main Apr 25, 2026
6 checks passed
@xingyaoww xingyaoww deleted the add-warning-api-sandbox-page branch April 25, 2026 02:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants