Using Reference Dependencies in Team Instructions

This example demonstrates how to use reference dependencies by defining them in the team constructor and referencing them directly in team instructions. This approach allows dependencies to be automatically injected into the team’s context and referenced using template variables in instructions.

1. Create a Python file

   reference_dependencies.py

   from datetime import datetime
   
   from agno.agent import Agent
   from agno.models.openai import OpenAIResponses
   from agno.team import Team
   
   
   def get_user_profile(user_id: str = "john_doe") -> dict:
       """Get user profile information that can be referenced in responses."""
       profiles = {
           "john_doe": {
               "name": "John Doe",
               "preferences": {
                   "communication_style": "professional",
                   "topics_of_interest": ["AI/ML", "Software Engineering", "Finance"],
                   "experience_level": "senior",
               },
               "location": "San Francisco, CA",
               "role": "Senior Software Engineer",
           }
       }
   
       return profiles.get(user_id, {"name": "Unknown User"})
   
   
   def get_current_context() -> dict:
       """Get current contextual information like time, weather, etc."""
       return {
           "current_time": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
           "timezone": "PST",
           "day_of_week": datetime.now().strftime("%A"),
       }
   
   
   profile_agent = Agent(
       name="ProfileAnalyst",
       model=OpenAIResponses(id="gpt-5.2"),
       instructions="You analyze user profiles and provide personalized recommendations.",
   )
   
   context_agent = Agent(
       name="ContextAnalyst",
       model=OpenAIResponses(id="gpt-5.2"),
       instructions="You analyze current context and timing to provide relevant insights.",
   )
   
   team = Team(
       name="PersonalizationTeam",
       model=OpenAIResponses(id="gpt-5.2"),
       members=[profile_agent, context_agent],
       dependencies={
           "user_profile": get_user_profile,
           "current_context": get_current_context,
       },
       instructions=[
           "You are a personalization team that provides personalized recommendations based on the user's profile and context.",
           "Here is the user profile: {user_profile}",
           "Here is the current context: {current_context}",
       ],
       debug_mode=True,
       markdown=True,
   )
   
   response = team.run(
       "Please provide me with a personalized summary of today's priorities based on my profile and interests.",
   )
   
   print(response.content)
   
2. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
3. Install dependencies

   uv pip install -U agno openai
   
4. Export your OpenAI API key

   export OPENAI_API_KEY=your_openai_api_key_here
   
5. Run Team

   python reference_dependencies.py