Documentation Index
Fetch the complete documentation index at: https://docs-v1.agno.com/llms.txt
Use this file to discover all available pages before exploring further.
Code
cookbook/agent_concepts/user_control_flows/external_tool_execution_async.py
import asyncio
import subprocess
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools import tool
from agno.utils import pprint
@tool(external_execution=True)
def execute_shell_command(command: str) -> str:
"""Execute a shell command.
Args:
command (str): The shell command to execute
Returns:
str: The output of the shell command
"""
if command.startswith("ls"):
return subprocess.check_output(command, shell=True).decode("utf-8")
else:
raise Exception(f"Unsupported command: {command}")
agent = Agent(
model=OpenAIChat(id="gpt-4o-mini"),
tools=[execute_shell_command],
markdown=True,
)
run_response = asyncio.run(agent.arun("What files do I have in my current directory?"))
if run_response.is_paused:
for tool in run_response.tools_awaiting_external_execution:
if tool.tool_name == execute_shell_command.name:
print(f"Executing {tool.tool_name} with args {tool.tool_args} externally")
# We execute the tool ourselves. You can also execute something completely external here.
result = execute_shell_command.entrypoint(**tool.tool_args)
# We have to set the result on the tool execution object so that the agent can continue
tool.result = result
run_response = asyncio.run(agent.acontinue_run(run_response=run_response))
pprint.pprint_run_response(run_response)
Usage
Create a virtual environment
Open the Terminal and create a python virtual environment.python3 -m venv .venv
source .venv/bin/activate
Set your API key
export OPENAI_API_KEY=xxx
Install libraries
pip install -U agno openai
Run Example
python cookbook/agent_concepts/user_control_flows/external_tool_execution_async.py
Key Features
- Uses
agent.arun() for asynchronous agent execution
- Implements
agent.acontinue_run() for async continuation
- Maintains the same external tool execution flow as synchronous version
- Demonstrates how to handle async execution with external tools
Use Cases
- Non-blocking external tool execution
- High-performance applications requiring async execution
- Web applications with external service calls
- Long-running operations with external tools