apogee-ai-sandbox¶
Run untrusted code (or agent code) in isolated sandboxes with policy gates.
Esta página está sendo ampliada
As tabelas abaixo são geradas do código-fonte do pacote, portanto estão corretas. Guias narrativos e exemplos comentados estão sendo escritos módulo a módulo.
API pública¶
Tudo abaixo é exportado pela raiz do pacote, então from apogee_ai_sandbox import X funciona para cada nome.
| Camada | Símbolos |
|---|---|
| Application | build_request |
| Application · DTOs | RunCodeDTO, RunResultDTO |
| Application · Use cases | KillJobUseCase, ListBackendsUseCase, RunCodeStreamUseCase, RunCodeUseCase |
| Domain | EgressAllowlist, ExecutionRequest, ExecutionResult, Fingerprint, JobStatus, Language, NetworkPolicy, OutputCacheKey, Quotas, SandboxFile, SandboxJob, StreamChunk |
| Domain · Enums | SandboxKind |
| Domain · Exceptions | EgressBlockedException, ExecutionTimeoutException, FingerprintMissingException, JobNotFoundException, LanguageNotSupportedException, QuotaExceededException, SandboxError, SandboxNotAvailableException |
| Domain · Protocols (ports) | IFingerprintCache, IQuotaEnforcer, ISandbox |
| Infrastructure | BubblewrapSandbox, CodeInterpreterTool, DaytonaSandboxAdapter, DockerSandboxAdapter, E2BSandboxAdapter, EchoSandbox, EgressAllowlistGate, FirejailSandbox, InMemoryFingerprintCache, InMemoryQuotaEnforcer, JsonFingerprintCache, LocalProcessSandbox, ModalSandboxAdapter, NotebookRunnerTool, SandboxRegistry, SandboxTool, SandboxToolDefinition, ShellRunnerTool, SqlRunnerTool, default_tool_catalog |
Instalação¶
A instalação base não tem dependência externa obrigatória. Cada extra habilita um adapter.
| Extra | Traz |
|---|---|
e2b |
e2b-code-interpreter>=1.0 |
modal |
modal>=0.64 |
daytona |
daytona-sdk>=0.10 |
docker |
docker>=7.0 |
all |
e2b-code-interpreter>=1.0, modal>=0.64, daytona-sdk>=0.10, docker>=7.0 |
CLI¶
Instalado como console script e registrado como plugin do apogee, então os mesmos subcomandos funcionam sob o binário global.
Leia a seguir¶
- Instalação
- Referência — todo símbolo público, gerado do código-fonte
- Apogee Framework — como os pacotes se encaixam