Where Each Option Belongs

Which options belong on AgentTeam and which belong on each Agent

AgentTeam (also exported as PraisonAIAgents) applies autonomy at the team level; the feature options belong on each Agent.

Quick Start

1. Put feature options on each Agent

   Give every agent its own web, knowledge, or other feature options.

   from praisonaiagents import Agent, AgentTeam
   
   researcher = Agent(
       name="Researcher",
       instructions="Research the topic.",
       web=True,                    # Feature options live on the Agent
       knowledge=["notes.txt"],
   )
   writer = Agent(
       name="Writer",
       instructions="Write a summary.",
       reflection=True,
   )
   
   team = AgentTeam(agents=[researcher, writer])
   team.start("Summarise the latest AI safety research")

2. Put autonomy on the team

   autonomy is the one option the team applies for you.

   from praisonaiagents import Agent, AgentTeam
   
   team = AgentTeam(
       agents=[Agent(name="Worker", instructions="Do the task.")],
       autonomy=True,               # Applied at the team level
   )
   team.start("Plan and execute the task")

How It Works

AgentTeam accepts six feature options for API symmetry with Agent, but does not apply them at the team level. Passing them logs a warning and ignores the value.

Common Patterns

Move the option down from the team onto each agent.

from praisonaiagents import Agent, AgentTeam

team = AgentTeam(
    agents=[
        Agent(name="Researcher", instructions="Research."),
        Agent(name="Writer", instructions="Write."),
    ],
    web=True,          # Warns and is ignored
)

from praisonaiagents import Agent, AgentTeam

team = AgentTeam(
    agents=[
        Agent(name="Researcher", instructions="Research.", web=True),
        Agent(name="Writer", instructions="Write.", web=True),
    ],
)

Best Practices

Related