Agents

​

Phidata Agents

• Use language models for reasoning and planning.
• Use tools to take actions and interact with external systems.
• Store memory and state in a database, remembering chat history, user preferences and conversation summaries.
• Store knowledge in vector databases to supplement their training data with domain expertise.

​

Example: Research Agent

Let’s create a research agent that can search the web, read the top links and write a report for us. We “prompt” the agent using description and instructions.

from phi.agent import Agent
from phi.model.openai import OpenAIChat
from phi.tools.duckduckgo import DuckDuckGo
from phi.tools.newspaper4k import Newspaper4k

agent = Agent(
    model=OpenAIChat(id="gpt-4o"),
    tools=[DuckDuckGo(), Newspaper4k()],
    description="You are a senior NYT researcher writing an article on a topic.",
    instructions=[
        "For a given topic, search for the top 5 links.",
        "Then read each URL and extract the article text, if a URL isn't available, ignore it.",
        "Analyse and prepare an NYT worthy article based on the information.",
    ],
    markdown=True,
    show_tool_calls=True,
    add_datetime_to_instructions=True,
    # debug_mode=True,
)
agent.print_response("Simulation theory", stream=True)

pip install phidata openai duckduckgo-search newspaper4k lxml_html_clean

python research_agent.py

​

Capturing the Agent’s response in a variable

While Agent.print_response() is useful for quick experiments, you will typically want to capture the agent’s response in a variable to either pass to your frontend, another agent or use in your application.

The Agent.run() function returns the response as a RunResponse object.

from phi.agent import Agent, RunResponse
from phi.utils.pprint import pprint_run_response

agent = Agent(...)

# Run agent and return the response as a variable
response: RunResponse = agent.run("Simulation theory")
# Print the response in markdown format
pprint_run_response(response, markdown=True)

By default stream=False, set stream=True to return a stream of RunResponse objects.

from typing import Iterator

# Run agent and return the response as a stream
response_stream: Iterator[RunResponse] = agent.run("Simulation theory", stream=True)
# Print the response stream in markdown format
pprint_run_response(response_stream, markdown=True, show_time=True)

​

RunResponse

The Agent.run() function returns a RunResponse object or an Iterator[RunResponse] if stream=True.

​

RunResponse Attributes