Exécution de code

ADK-Rust fournit l’exécution de code via deux crates :

• adk-sandbox — Environnement d’exécution isolé avec ProcessBackend (sous-processus) et WasmBackend (wasmtime)
• adk-code — Chaîne d’outils adaptée au langage avec RustExecutor (pipeline de vérification, compilation et exécution) et CodeTool

La séparation est intentionnelle : adk-sandbox gère l’isolation, tandis que adk-code gère la compilation et la logique spécifique au langage.

Démarrage rapide

use adk_code::{CodeTool, RustExecutor, RustExecutorConfig};
use adk_sandbox::ProcessBackend;
use std::sync::Arc;

let backend = Arc::new(ProcessBackend::default());
let executor = RustExecutor::new(backend, RustExecutorConfig::default());
let tool = Arc::new(CodeTool::new(executor));

let agent = LlmAgentBuilder::new("code_agent")
    .instruction("Execute Rust code when asked to compute something.")
    .model(model)
    .tool(tool)
    .build()?;

Pour une exécution directe dans le bac à sable sans le pipeline de compilation Rust :

use adk_sandbox::{SandboxTool, ProcessBackend};
use std::sync::Arc;

let backend = Arc::new(ProcessBackend::default());
let tool = Arc::new(SandboxTool::new(backend));

Architecture

CodeTool ajoute un pipeline de compilation Rust (vérification des erreurs, compilation du binaire, puis exécution). SandboxTool exécute directement le code via le backend, sans compilation.

Matrice des capacités des backends

ProcessBackend est transparent quant à ce qu’il n’impose pas. Utilisez WasmBackend pour une mise en bac à sable complète ou DockerExecutor pour une isolation au niveau du conteneur.

Outils

CodeTool, SandboxTool et MontyPythonCodeTool suivent le modèle des erreurs comme informations : les erreurs sont renvoyées sous forme de JSON structurées avec un champ "status", jamais sous forme de ToolError. Cela permet aux agents de raisonner sur les échecs. PythonCodeTool constitue l’exception : il renvoie un ToolError en cas d’argument code manquant et pour les échecs au niveau de l’exécuteur ; seuls les échecs au niveau du script sont exposés sous forme de données.

Pour l’exécution de Python en processus — modes à exécution unique et REPL, autorisations d’accès au système d’exploitation et fonctions hôtes — consultez Exécution de code Python.

Diagnostics structurés

CodeTool renvoie les diagnostics du compilateur analysés pour les erreurs de compilation Rust :

{
  "status": "compile_error",
  "diagnostics": [
    {
      "level": "error",
      "message": "expected `;`",
      "code": "E0308",
      "spans": [{ "file_name": "main.rs", "line_start": 3, "column_start": 15 }]
    }
  ],
  "stderr": "error: expected `;`"
}

Les réponses en cas de réussite incluent la sortie structurée extraite du harnais :

{
  "status": "success",
  "stdout": "",
  "output": { "greeting": "hello" },
  "exit_code": 0,
  "duration_ms": 42
}

Contrat du code Rust

Le code utilisateur doit fournir fn run(input: serde_json::Value) -> serde_json::Value. Le harnais l’enveloppe avec fn main(), l’analyse de stdin et la sérialisation de stdout. Le code utilisateur ne doit pas définir fn main() ni utiliser d’attributs au niveau de la crate (#![...]).

Migration depuis API précédent

Les types adk-code précédents (CodeExecutor, ExecutionRequest, RustSandboxExecutor) ainsi que le RustCodeTool de adk-tool ont été supprimés. Utilisez plutôt les nouveaux types :

Voir adk_code::compat pour le guide complet de migration.

Navigateur JavaScript

L’exécution de pages dans le navigateur JavaScript via adk-browser constitue une fonctionnalité distincte. Elle s’exécute dans le contexte de la page distante et ne fait pas partie de la plateforme d’exécution du code. Utilisez les outils adk-browser pour l’automatisation du Web et l’interaction avec les pages.

Intégration de Studio

ADK Studio utilise le même pipeline d’exécution du code :

• Exécuteur en direct : exécute le code Rust rédigé via RustExecutor + ProcessBackend
• Génération de code : intègre le même corps Rust dans les projets générés
• Paramètres du bac à sable : correspondent aux capacités pouvant être appliquées par le backend