README

README.md

@@ -225,14 +225,18 @@ if __name__ == "__main__":
     serve_playground_app("playground:app", reload=True)
 ```
 
-Authenticate with phidata:
 
-```
+Authenticate with phidata by running the following command:
+
+```shell
 phi auth
 ```
 
-> [!NOTE]
-> If `phi auth` fails, you can set the `PHI_API_KEY` environment variable by copying it from [phidata.app](https://www.phidata.app)
+or by exporting the `PHI_API_KEY` for your workspace from [phidata.app](https://www.phidata.app)
+
+```bash
+export PHI_API_KEY=phi-***
+```
 
 Install dependencies and run the Agent Playground:
 
@@ -383,9 +387,6 @@ python reasoning_agent.py
 >
 > It is an experiment fueled by curiosity, combining COT and tool use. Set your expectations very low for this initial release. For example: It will not be able to count ‘r’s in ‘strawberry’.
 
-> [!TIP]
-> If using tools with `reasoning=True`, set `structured_outputs=False` because gpt-4o doesnt support tools with structured outputs.
-
 ## Demo Agents
 
 The Agent Playground includes a few demo agents that you can test with. If you have recommendations for other demo agents, please let us know in our [community forum](https://community.phidata.com/).

cookbook/agents/43_research_agent_exa.py

@@ -0,0 +1,55 @@
+"""Please install dependencies using:
+pip install openai exa-py phidata
+"""
+
+from textwrap import dedent
+from datetime import datetime
+
+from phi.agent import Agent
+from phi.model.openai import OpenAIChat
+from phi.tools.exa import ExaTools
+
+agent = Agent(
+    model=OpenAIChat(id="gpt-4o"),
+    tools=[ExaTools(start_published_date=datetime.now().strftime("%Y-%m-%d"), type="keyword")],
+    description="You are an advanced AI researcher writing a report on a topic.",
+    instructions=[
+        "For the provided topic, run 3 different searches.",
+        "Read the results carefully and prepare a NYT worthy report.",
+        "Focus on facts and make sure to provide references.",
+    ],
+    expected_output=dedent("""\
+    An engaging, informative, and well-structured report in markdown format:
+
+    ## Engaging Report Title
+
+    ### Overview
+    {give a brief introduction of the report and why the user should read this report}
+    {make this section engaging and create a hook for the reader}
+
+    ### Section 1
+    {break the report into sections}
+    {provide details/facts/processes in this section}
+
+    ... more sections as necessary...
+
+    ### Takeaways
+    {provide key takeaways from the article}
+
+    ### References
+    - [Reference 1](link)
+    - [Reference 2](link)
+    - [Reference 3](link)
+
+    ### About the Author
+    {write a made up for yourself, give yourself a cyberpunk name and a title}
+
+    - published on {date} in dd/mm/yyyy
+    """),
+    markdown=True,
+    show_tool_calls=True,
+    add_datetime_to_instructions=True,
+    save_response_to_file="tmp/{message}.md",
+    # debug_mode=True,
+)
+agent.print_response("Simulation theory", stream=True)