Agent Sandbox with ADK agent #195

ArthurKamalov · 2025-12-01T20:15:33Z

This PR introduces the guide on how to create an ADK agent to use the sandbox agent as a tool.

k8s-ci-robot · 2025-12-01T20:15:39Z

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: ArthurKamalov
Once this PR has been reviewed and has the lgtm label, please assign soltysh for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

k8s-ci-robot · 2025-12-01T20:15:42Z

Hi @ArthurKamalov. Thanks for your PR.

I'm waiting for a github.com member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

netlify · 2025-12-01T20:18:32Z

✅ Deploy Preview for agent-sandbox ready!

Name	Link
🔨 Latest commit	`5b47bb9`
🔍 Latest deploy log	https://app.netlify.com/projects/agent-sandbox/deploys/692df767f102ad00081afb6b
😎 Deploy Preview	https://deploy-preview-195--agent-sandbox.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

janetkuo · 2025-12-01T21:00:26Z

/ok-to-test

k8s-ci-robot · 2025-12-01T21:00:51Z

@ArthurKamalov: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name	Commit	Details	Required	Rerun command
presubmit-test-autogen-up-to-date	`5b47bb9`	link	true	`/test presubmit-test-autogen-up-to-date`

Full PR test history. Your PR dashboard. Please help us cut down on flakes by linking to an open issue when you hit one in your PR.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

janetkuo · 2025-12-01T21:04:16Z

examples/code-interpreter-agent-on-adk/README.md

+
+5. Install the dependencies:
+   ```sh
+   pip install -r requirements.txt


Install using git

Suggested change

pip install -r requirements.txt

export VERSION="main"

pip install google-adk==1.19.0 "git+https://github.com/kubernetes-sigs/agent-sandbox.git@${VERSION}#subdirectory=clients/python/agentic-sandbox-client"

janetkuo · 2025-12-01T21:06:00Z

examples/code-interpreter-agent-on-adk/README.md

@@ -0,0 +1,50 @@
+# Use Agent Sanbox code interpreter an Agent Tool.  


Suggested change

# Use Agent Sanbox code interpreter an Agent Tool.

# Using Agent Sandbox as a Tool in Agent Development Kit (ADK)

janetkuo · 2025-12-01T21:06:25Z

examples/code-interpreter-agent-on-adk/README.md

@@ -0,0 +1,50 @@
+# Use Agent Sanbox code interpreter an Agent Tool.  
+
+The guide will guide you through the process of creating a simple [ADK](https://google.github.io/adk-docs/) agent that is able to use agent sandbox as a tool.


Avoid repetitive "guide will guide"

Suggested change

The guide will guide you through the process of creating a simple [ADK](https://google.github.io/adk-docs/) agent that is able to use agent sandbox as a tool.

The guide walks you through the process of creating a simple [ADK](https://google.github.io/adk-docs/) agent that is able to use agent sandbox as a tool.

janetkuo · 2025-12-01T21:07:06Z

examples/code-interpreter-agent-on-adk/README.md

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


Suggested change

6. Set you API key to get access the Gemini model that is used in this example:

6. Set your API key to access the Gemini model that is used in this example:

janetkuo · 2025-12-01T21:07:27Z

examples/code-interpreter-agent-on-adk/README.md

+
+## Testing
+
+1. Open agent's page: http://127.0.0.1:8000.


Suggested change

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

1. Open the agent's page: http://127.0.0.1:8000.

janetkuo · 2025-12-01T21:16:51Z

examples/code-interpreter-agent-on-adk/coding_agent/agent.py

+def execute_python(code: str):
+    with SandboxClient(
+        template_name="python-sandbox-template",
+        namespace="default"


This assumes this exact template already exists in the cluster, but the example didn't mention that

janetkuo · 2025-12-01T21:26:27Z

site/content/docs/guides/code-interpreter-agent-on-adk/_index.md

@@ -0,0 +1,8 @@
+---


I suggest we avoid adding more docs in the site, given that the links and graphs don't render well in the site yet (they work better in md). We should add those after the issues are fixed, for better UX.

janetkuo · 2025-12-01T21:30:27Z

examples/code-interpreter-agent-on-adk/README.md

+
+3. Move into this example's folder:
+   ```sh
+   cd examples/code-interpreter-agent-on-adk


Since agent.py is only ~20 lines long, maybe we can simplify this guide by removing the 'clone repository' requirement?

We could structure it as a 'build from scratch' tutorial:

Use the pip install ... command (with the git URL) to install dependencies.

Run adk create coding_agent to scaffold the folder.

Ask the user to copy-paste the code into agent.py.

adk web coding_agent

This allows users to try the example quickly without downloading the full agent-sandbox repo.

ArthurKamalov added 4 commits November 28, 2025 11:34

add initial code interpreter agent guide

a69ffd2

fix links

dbb90e8

change title

8be3ed2

fix broken link

5b47bb9

k8s-ci-robot requested review from janetkuo and soltysh December 1, 2025 20:15

k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Dec 1, 2025

k8s-ci-robot added needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Dec 1, 2025

k8s-ci-robot added ok-to-test Indicates a non-member PR verified by an org member that is safe to test. and removed needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Dec 1, 2025

janetkuo reviewed Dec 1, 2025

View reviewed changes

	pip install -r requirements.txt
	export VERSION="main"
	pip install google-adk==1.19.0 "git+https://github.com/kubernetes-sigs/agent-sandbox.git@${VERSION}#subdirectory=clients/python/agentic-sandbox-client"

		@@ -0,0 +1,50 @@
		# Use Agent Sanbox code interpreter an Agent Tool.

	# Use Agent Sanbox code interpreter an Agent Tool.
	# Using Agent Sandbox as a Tool in Agent Development Kit (ADK)

		@@ -0,0 +1,50 @@
		# Use Agent Sanbox code interpreter an Agent Tool.

		The guide will guide you through the process of creating a simple [ADK](https://google.github.io/adk-docs/) agent that is able to use agent sandbox as a tool.

	The guide will guide you through the process of creating a simple [ADK](https://google.github.io/adk-docs/) agent that is able to use agent sandbox as a tool.
	The guide walks you through the process of creating a simple [ADK](https://google.github.io/adk-docs/) agent that is able to use agent sandbox as a tool.

	6. Set you API key to get access the Gemini model that is used in this example:
	6. Set your API key to access the Gemini model that is used in this example:

	1. Open agent's page: http://127.0.0.1:8000.
	1. Open the agent's page: http://127.0.0.1:8000.

Agent Sandbox with ADK agent #195

Are you sure you want to change the base?

Agent Sandbox with ADK agent #195

Uh oh!

Conversation

ArthurKamalov commented Dec 1, 2025

Uh oh!

k8s-ci-robot commented Dec 1, 2025

Uh oh!

k8s-ci-robot commented Dec 1, 2025

Uh oh!

netlify bot commented Dec 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for agent-sandbox ready!

Uh oh!

janetkuo commented Dec 1, 2025

Uh oh!

k8s-ci-robot commented Dec 1, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

netlify bot commented Dec 1, 2025 •

edited

Loading