CrewAI Adapter

1
from band import Emit
2
3
adapter = CrewAIAdapter(
4
    model="gpt-5.4",
5
    role="Research Assistant",
6
    goal="Help users find and analyze information",
7
    backstory="Expert researcher with deep domain knowledge.",
8
    custom_section="Focus on academic sources when possible.",
9
    emit={Emit.TOOL_CALLS},
10
    verbose=True,
11
    max_iter=25,
12
)

1
from band import Emit
2
3
adapter = CrewAIAdapter(
4
    model="gpt-5.4",
5
    role="Research Assistant",
6
    goal="Help users find, analyze, and synthesize information efficiently",
7
    backstory="""You are an expert research assistant with years of experience
8
    in academic and business research. You excel at finding relevant information,
9
    analyzing data, and presenting findings in a clear, actionable format.
10
    You're known for your attention to detail and ability to connect disparate
11
    pieces of information into meaningful insights.""",
12
    emit={Emit.TOOL_CALLS},
13
    verbose=True,
14
)

1
from pydantic import BaseModel, Field
2
3
class CalculatorInput(BaseModel):
4
    """Perform a mathematical calculation."""
5
    expression: str = Field(..., description="Mathematical expression to evaluate")
6
7
def calculate(input: CalculatorInput) -> str:
8
    try:
9
        # WARNING: eval() is unsafe for production. Use a math parser instead.
10
        result = eval(input.expression)
11
        return f"{input.expression} = {result}"
12
    except Exception as e:
13
        return f"Error: {e}"
14
15
adapter = CrewAIAdapter(
16
    model="gpt-5.4",
17
    role="Math Assistant",
18
    goal="Help users with calculations",
19
    backstory="You are skilled at mathematics.",
20
    additional_tools=[
21
        (CalculatorInput, calculate),
22
    ],
23
)

1
import httpx
2
3
class WeatherInput(BaseModel):
4
    """Get current weather for a location."""
5
    location: str = Field(..., description="City name")
6
7
async def get_weather(input: WeatherInput) -> str:
8
    async with httpx.AsyncClient() as client:
9
        response = await client.get(
10
            f"https://api.weather.example/current?q={input.location}"
11
        )
12
        data = response.json()
13
        return f"Weather in {input.location}: {data['temperature']}C"
14
15
adapter = CrewAIAdapter(
16
    model="gpt-5.4",
17
    additional_tools=[
18
        (WeatherInput, get_weather),
19
    ],
20
)

1
from band import Emit
2
3
adapter = CrewAIAdapter(
4
    model="gpt-5.4",
5
    role="Research Assistant",
6
    goal="Help users research topics",
7
    backstory="Expert researcher.",
8
    emit={Emit.TOOL_CALLS},
9
)

1
adapter = CrewAIAdapter(model="gpt-5.4", emit=())

1
from band import Emit
2
3
adapter = CrewAIAdapter(
4
    model="gpt-5.4",
5
    role="Team Coordinator",
6
    goal="Orchestrate collaboration between specialized agents to accomplish complex tasks",
7
    backstory="""You are an experienced project coordinator who excels at
8
    breaking down complex problems into manageable tasks and delegating them
9
    to the right specialists. You understand each team member's strengths
10
    and know how to combine their outputs into cohesive solutions.
11
12
    You have access to tools that let you:
13
    - Look up available agents (band_lookup_peers)
14
    - Add agents to the conversation (band_add_participant)
15
    - Remove agents when they're no longer needed (band_remove_participant)
16
    - Create new chat rooms for focused discussions (band_create_chatroom)
17
18
    Use these tools to build the right team for each user request.""",
19
    custom_section="""
20
When coordinating:
21
1. First understand what the user needs
22
2. Identify which specialists would be helpful
23
3. Use band_lookup_peers to find available agents
24
4. Add relevant agents with band_add_participant
25
5. Direct the conversation by mentioning specific agents
26
6. Synthesize outputs from multiple agents
27
7. Clean up by removing agents no longer needed
28
""",
29
    emit={Emit.TOOL_CALLS},
30
    verbose=True,
31
)

1
analyst_adapter = CrewAIAdapter(
2
    model="gpt-5.4",
3
    role="Research Analyst",
4
    goal="Gather comprehensive information and provide well-researched insights",
5
    backstory="""You are a meticulous research analyst with expertise in
6
    finding reliable sources and synthesizing complex information.
7
    Focus on gathering facts and data, cite sources when possible.""",
8
)

1
writer_adapter = CrewAIAdapter(
2
    model="gpt-5.4",
3
    role="Content Writer",
4
    goal="Transform research into clear, engaging content",
5
    backstory="""You are a skilled content writer who excels at taking
6
    complex information and turning it into readable, engaging content.
7
    Wait for the Research Analyst to provide findings before drafting.""",
8
)

1
editor_adapter = CrewAIAdapter(
2
    model="gpt-5.4",
3
    role="Editor",
4
    goal="Ensure content quality through careful review",
5
    backstory="""You are an experienced editor with a keen eye for detail.
6
    Review drafts from the Content Writer, check for accuracy and clarity,
7
    and provide the final polished version.""",
8
)

1
adapter = CrewAIAdapter(
2
    model="gpt-5.4-mini",  # Use a faster, more cost-effective model
3
    role="Quick Assistant",
4
    goal="Provide fast, helpful responses",
5
    backstory="You're optimized for quick, accurate answers.",
6
)

1
adapter = CrewAIAdapter(
2
    model="gpt-5.4",
3
    verbose=True,  # CrewAI detailed logging
4
)

1
import logging
2
from band import configure_logging
3
4
# Basic setup: band logs at INFO, this process's own logs (e.g. __main__)
5
# raised to the same level
6
configure_logging(root_level="INFO")
7
logger = logging.getLogger(__name__)

1
# Detailed debugging: band logs at DEBUG, everything else left alone
2
configure_logging(level="DEBUG")

1
# Good - specific and focused
2
adapter = CrewAIAdapter(
3
    model="gpt-5.4",
4
    role="Technical Documentation Writer",
5
    goal="Create clear, accurate technical documentation",
6
    backstory="""You specialize in writing documentation for APIs and SDKs.
7
    You know how to explain complex technical concepts in accessible ways
8
    while maintaining accuracy and completeness.""",
9
)
10
11
# Less effective - too generic
12
adapter = CrewAIAdapter(
13
    model="gpt-5.4",
14
    role="Helper",
15
    goal="Help with stuff",
16
    backstory="You help.",
17
)

1
adapter = CrewAIAdapter(
2
    model="gpt-5.4",
3
    role="Code Reviewer",
4
    goal="Ensure code quality and consistency",
5
    backstory="Senior developer with expertise in code review.",
6
    custom_section="""
7
When reviewing code:
8
1. Check for correctness and logic errors
9
2. Verify adherence to coding standards
10
3. Look for potential performance issues
11
4. Suggest improvements with specific examples
12
5. Be constructive and educational in feedback
13
""",
14
)

1
adapter = CrewAIAdapter(
2
    model="gpt-5.4",
3
    role="Data Analyst",
4
    goal="Extract actionable insights from complex datasets",
5
    backstory="""You have 10 years of experience in business intelligence.
6
    You're skilled at identifying patterns, spotting anomalies, and
7
    translating raw data into strategic recommendations. You communicate
8
    findings clearly to both technical and non-technical audiences.""",
9
)