Repository navigation
Lead the common.ai sandbox docs with when to use it and where each piece runs - #74297
Merged
Merged
Conversation
…ece runs The sandbox page opened on the problem and only answered "should I use this, or the executor, the pod operator or code mode?" across four sections further down. It now opens with that answer, draws what moves into the sandbox and what stays on the worker, merges the two overlapping limitation lists, and shows the task log and XCom of a real run of the quick-start agent on Modal.
kaxil
force-pushed
the
sandbox-docs-restructure
branch
from
October 5, 2026 23:03
7039a0e to
cc6b620
Compare
vatsrahul1001
approved these changes
Oct 6, 2026
eladkal
approved these changes
Oct 6, 2026
# Conflicts: # providers/common/ai/docs/sandbox/index.rst
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The sandbox guide answered "should I use this, or
KubernetesExecutor,KubernetesPodOperatoror code mode?" in four separate sections well down the page, and carried two overlapping lists of limitations. This reorganizessandbox/index.rstaround that decision:SQLToolset/HookToolset), code mode,KubernetesExecutor,KubernetesPodOperator.sbxon the worker host versus Modal and OpenSandbox off it, and lists the provisioning credential for each backend.sandbox-limitationslabel, each item linking to where it is explained. Claims that read as universal but are backend-specific are now scoped: attaching works on Modal only, running as root is documented for Modal, andsbxneeds KVM only on Linux.FindingsXCom from running the investigation example on Modal against a seeded Postgres warehouse, the exact errorsbxraises for a bareSandboxSpec(), and theUsageLimitExceedederror that one of the two captured runs hit at pydantic-ai's default 50-request limit, with how to raise it.sbx.concepts.rstnow links to the new placement section, andbackends.rstgains asandbox-backend-sbxlabel. No existing label was removed or renamed, so inbound links still resolve. The docs build and spellcheck pass.Found while capturing the output, not changed here: the
AgentOperatordocstring saysusage_limits=None"means no enforcement", but pydantic-ai's defaultrequest_limit=50still applies, which is what the failed run hit. That is a one-line docstring fix for a separate PR.{pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.