Skip to content

ASB docs - #2670

Open
samuelcolvin wants to merge 9 commits into
mainfrom
agent-sandboxes-docs
Open

samuelcolvin wants to merge 9 commits into
mainfrom
agent-sandboxes-docs

Conversation

@samuelcolvin

@samuelcolvin samuelcolvin commented Oct 25, 2026 •

Copy link
Copy Markdown
Member

Docs for logfire.agent_sandboxes(), split out of #2658 so the feature can be released for beta testing before the docs are published.

Based on agent-sandboxes: merge #2658 first, then retarget this PR to main.

  • New top-level Agent Sandboxes nav section:
    • agent-sandboxes/index.md: overview, when to use sandboxes and when not to.
    • agent-sandboxes/python.md: install, API key, first snippet, host functions, tracing, pool options.
    • agent-sandboxes/sessions.md: persisting, resuming, snapshots, forks, ephemeral sessions, and a list mapping terms used by other sandbox platforms (pause/resume, hibernate, checkpoint, fork, TTL, failover) to these features.
  • A project:execute_agent_sandboxes row in the API key scopes table. The label and the key rules match pydantic-data-platform #50108: the UI checkbox reads "Run code in this project's agent sandboxes", and the Monty resolver rejects organization keys and personal keys (except Workbench keys).
  • A pointer from the Monty integration page.
  • Removes the !^agent_sandboxes$ filters that ASB #2658 adds to reference/api/logfire.md, so the method appears in the API reference.

Open questions:

  • Should the docs mark Agent Sandboxes as Beta?

The session snippets were checked against a local monty-server with a file store, not staging.

🤖 Generated with Claude Code

https://claude.ai/code/session_01N2BkYWq7LvMK571ryZbia3

samuelcolvin and others added 5 commits October 23, 2026 14:40
Returns a pydantic_monty.AsyncMontyWebsocket pool authenticated with a Logfire
API key, with the URL inferred from the key's region. Requires the new
agent-sandboxes extra, and enables instrument_monty() unless instrument=False.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N2BkYWq7LvMK571ryZbia3
… sessions

Adds a sessions page covering what state is saved, when sessions are parked,
resume by session ID, dump() snapshots as checkpoints, forking, ephemeral
sessions, retention, and how these map to terms used elsewhere. Fixes the
claim in the Python page that state is discarded when a session closes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N2BkYWq7LvMK571ryZbia3
The feature is released for beta testing before the docs are published.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N2BkYWq7LvMK571ryZbia3
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N2BkYWq7LvMK571ryZbia3
@samuelcolvin samuelcolvin mentioned this pull request Oct 25, 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.

All reported issues were addressed across 7 files

Reply with feedback, questions, or to request a fix.

View guided diff | Re-trigger cubic

Comment thread docs/reference/advanced/use-api-keys.md Outdated
Comment thread docs/agent-sandboxes/sessions.md
Comment thread docs/agent-sandboxes/python.md Outdated
Comment thread docs/agent-sandboxes/index.md Outdated
Comment thread docs/agent-sandboxes/sessions.md Outdated
Comment thread docs/agent-sandboxes/sessions.md Outdated
Comment thread docs/agent-sandboxes/sessions.md Outdated
Comment thread docs/agent-sandboxes/python.md Outdated

@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.

All reported issues were addressed across 3 files (changes from recent commits).

Reply with feedback, questions, or to request a fix.

View guided diff | Re-trigger cubic

Comment thread docs/reference/advanced/use-api-keys.md Outdated
Comment thread docs/agent-sandboxes/python.md
Comment thread docs/agent-sandboxes/index.md
Comment thread docs/reference/advanced/use-api-keys.md Outdated
samuelcolvin and others added 3 commits October 25, 2026 18:08
Fix the admonitions, retry the resume example until the save completes,
treat session IDs as opaque bytes, drop idle parking (disabled in every
deployment), and say which API keys Agent Sandboxes accept.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N2BkYWq7LvMK571ryZbia3
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N2BkYWq7LvMK571ryZbia3
Base automatically changed from agent-sandboxes to main October 26, 2026 10:49

This branch has not been deployed

No deployments
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.

1 participant