Common Use Cases

from pydantic import Field
from agency_swarm import SendMessage

class SendMessageTask(SendMessage):
    """Use this tool to send tasks to other agents within your agency."""

    tool_name = "send_message_task"  # optional, defaults to "send_message"

    task: str = Field(
        description=(
            "Specify the task required for the recipient agent to complete. Focus on "
            "clarifying what the task entails rather than providing exact instructions."
        )
    )

from pydantic import Field
from agency_swarm import SendMessage

class SendMessageWithContext(SendMessage):
    """SendMessage with key moments and decisions tracking."""

    tool_name = "send_message_with_context"

    key_moments: str = Field(
        description=(
            "Document critical moments and decision points from the current conversation "
            "that the recipient agent needs to understand. Include context about what "
            "has been decided or prioritized that will guide the recipient's tool selection "
            "and task execution. For example: 'User decided to prioritize performance over cost', "
            "'Analysis focus shifted to Q4 optimization', etc."
        )
    )
    decisions: str = Field(
        description=(
            "Summarize the specific decisions made that will directly impact which tools "
            "or approaches the recipient agent should use. Be explicit about choices that "
            "narrow down the scope of work. For example: 'Prioritized performance analysis "
            "over cost reduction', 'Selected React over Vue for frontend', etc. This helps "
            "the recipient agent choose the most appropriate tools and approach."
        )
    )

from agency_swarm import Agency, Agent

agent = Agent(
    name="MyAgent",
    instructions="You are a helpful assistant.",
)

other_agent = Agent(name="OtherAgent", instructions="Provide supporting context.")

agency = Agency(
    agent,
    other_agent,
    communication_flows=[(agent > other_agent, SendMessageWithContext)],
)