ASB docs

SA
10h ago
+554-3

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 #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