Exceptions

If after a tool call we need to “retry” the model with a different set of instructions or stop the agent, we can raise one of the following exceptions:

RetryAgentRun: Use this exception when you want to retry the agent run with a different set of instructions.
StopAgentRun: Use this exception when you want to stop the agent run.
AgentRunException: A generic exception that can be used to retry the tool call.

This example shows how to use the RetryAgentRun exception to retry the agent with additional instructions.

retry_in_tool_call.py

from agno.agent import Agent
from agno.exceptions import RetryAgentRun
from agno.models.openai import OpenAIChat
from agno.utils.log import logger


def add_item(agent: Agent, item: str) -> str:
    """Add an item to the shopping list."""
    agent.session_state["shopping_list"].append(item)
    len_shopping_list = len(agent.session_state["shopping_list"])
    if len_shopping_list < 3:
        raise RetryAgentRun(
            f"Shopping list is: {agent.session_state['shopping_list']}. Minimum 3 items in the shopping list. "
            + f"Add {3 - len_shopping_list} more items.",
        )

    logger.info(f"The shopping list is now: {agent.session_state.get('shopping_list')}")
    return f"The shopping list is now: {agent.session_state.get('shopping_list')}"


agent = Agent(
    model=OpenAIChat(id="gpt-4o-mini"),
    # Initialize the session state with empty shopping list
    session_state={"shopping_list": []},
    tools=[add_item],
    markdown=True,
)
agent.print_response("Add milk", stream=True)
print(f"Final session state: {agent.session_state}")

Make sure to set AGNO_DEBUG=True to see the debug logs.

Writing your own tools Hooks

Introduction

Concepts

Other

How to