Interact with Agent Sandbox interpreter by ADK Agent

This guide documents the example setup with ADK agent that can interact with the Agent Sandbox.

The guide will guide you through the process of creating a simple ADK agent that is able to use agent sandbox as a tool.

Installation

  1. Install the Agent-Sandbox controller and CRDs to a cluster. You can follow the instructions from the installation section from the Getting Started page.

  2. Install the Agent Sandbox router

  3. Move into this example’s folder:

    cd examples/code-interpreter-agent-on-adk
    
  4. Create a Python virtual environment:

    python3 -m venv .venv
    source .venv/bin/activate
    
  5. Install the dependencies:

    pip install -r requirements.txt
    
  6. Set you API key to get access the Gemini model that is used in this example:

    export GOOGLE_API_KEY="YOUR_API_KEY"
    
  7. Start ADK agent with the web UI:

    adk web
    

Testing

  1. Open agent’s page: http://127.0.0.1:8000.

  2. Tell the agent to generate some code and execute it in the sandbox:

example

The agent should generate the code and execute it in the agent-sandbox.


Last modified December 1, 2025: change title (8be3ed2)