Files

T

History

Liang Wu 5c6376b7b0 feat(environment): Add LocalEnvironment for executing commands and file I/O locally

This change introduces the LocalEnvironment class, which allows agents to execute shell commands and perform file operations using asyncio subprocesses on the local machine. It includes support for a working directory and custom environment variables. A sample agent configuration is also added to demonstrate its usage.

Co-authored-by: Liang Wu <wuliang@google.com>
PiperOrigin-RevId: 890685517
Change-Id: Ibe948643077fc606cb2a5cf395b67c65af32d7f7

2026-04-07 22:57:17 -07:00

__init__.py

feat(environment): Add LocalEnvironment for executing commands and file I/O locally

2026-04-07 22:57:17 -07:00

agent.py

feat(environment): Add LocalEnvironment for executing commands and file I/O locally

2026-04-07 22:57:17 -07:00

README.md

feat(environment): Add LocalEnvironment for executing commands and file I/O locally

2026-04-07 22:57:17 -07:00

README.md

Local Environment Sample

This sample demonstrates how to use the LocalEnvironment with the EnvironmentToolset to allow an agent to interact with the local filesystem and execute commands.

Description

The agent is configured with the EnvironmentToolset, which provides tools for file I/O (reading, writing) and command execution within a local environment. This allows the agent to perform tasks that involve creating files, modifying them, and running local scripts or commands.

Sample Usage

You can interact with the agent by providing prompts that require file operations and command execution.

Example Prompt

"Write a Python file named hello.py to the working directory that prints 'Hello from ADK!'. Then read the file to verify its contents, and finally execute it using a command."

Expected Behavior

Write File: The agent uses a tool to write hello.py with the content print("Hello from ADK!").
Read File: The agent uses a tool to read hello.py and verify the content.
Execute Command: The agent uses a tool to run python3 hello.py and returns the output.