CrewAI Adapter

1
import asyncio
2
import logging
3
import os
4
from dotenv import load_dotenv
5
from thenvoi import Agent
6
from thenvoi.adapters import CrewAIAdapter
7
from thenvoi.config import load_agent_config
8
9
logging.basicConfig(level=logging.INFO)
10
logger = logging.getLogger(__name__)
11
12
async def main():
13
    load_dotenv()
14
15
    # Load agent credentials
16
    agent_id, api_key = load_agent_config("my_agent")
17
18
    # Create adapter with model
19
    adapter = CrewAIAdapter(
20
        model="gpt-4o",
21
        custom_section="You are a helpful assistant. Be concise and friendly.",
22
    )
23
24
    # Create and run the agent
25
    agent = Agent.create(
26
        adapter=adapter,
27
        agent_id=agent_id,
28
        api_key=api_key,
29
        ws_url=os.getenv("THENVOI_WS_URL"),
30
        rest_url=os.getenv("THENVOI_REST_URL"),
31
    )
32
33
    logger.info("Agent is running! Press Ctrl+C to stop.")
34
    await agent.run()
35
36
if __name__ == "__main__":
37
    asyncio.run(main())

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

1
adapter = CrewAIAdapter(
2
    # Model to use (OpenAI-compatible)
3
    model="gpt-4o",
4
5
    # CrewAI-style agent definition
6
    role="Research Assistant",
7
    goal="Help users find information",
8
    backstory="Expert researcher with attention to detail.",
9
10
    # Custom instructions to append to the system prompt
11
    custom_section="Focus on academic sources.",
12
13
    # Override the entire system prompt
14
    system_prompt=None,
15
16
    # OpenAI API key (uses OPENAI_API_KEY env var if not set)
17
    openai_api_key=None,
18
19
    # Enable visibility into tool calls and results
20
    enable_execution_reporting=False,
21
22
    # Enable detailed logging
23
    verbose=False,
24
)

1
adapter = CrewAIAdapter(
2
    model="gpt-4o",
3
    role="Research Assistant",
4
    goal="Help users research topics",
5
    backstory="Expert researcher.",
6
    enable_execution_reporting=True,
7
)

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

1
adapter = CrewAIAdapter(
2
    model="gpt-4o",
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, analyzing data, and synthesizing complex information
7
    into actionable insights. You're known for your thoroughness and ability to
8
    uncover relevant details that others might miss.
9
10
    When working with the crew:
11
    - Focus on gathering facts and data
12
    - Cite sources when possible
13
    - Present findings clearly for the writer to use
14
    - Flag any uncertainties or gaps in information""",
15
    custom_section="""
16
Your workflow:
17
1. When asked to research a topic, gather comprehensive information
18
2. Organize findings into clear categories
19
3. Highlight key insights and important details
20
4. Pass your research to @Content Writer for drafting
21
""",
22
)

1
adapter = CrewAIAdapter(
2
    model="gpt-4o",
3
    role="Content Writer",
4
    goal="Transform research into clear, engaging, and well-structured content",
5
    backstory="""You are a skilled content writer who excels at taking
6
    complex information and turning it into readable, engaging content.
7
    You have a talent for finding the right tone and structure for any
8
    audience, and you always aim for clarity without sacrificing depth.
9
10
    When working with the crew:
11
    - Wait for the Research Analyst to provide findings
12
    - Create well-structured drafts based on research
13
    - Use clear, accessible language
14
    - Pass drafts to the Editor for review""",
15
    custom_section="""
16
Your workflow:
17
1. Review research provided by @Research Analyst
18
2. Create a well-structured draft with clear sections
19
3. Ensure the content flows logically
20
4. Send your draft to @Editor for review and refinement
21
""",
22
)

1
adapter = CrewAIAdapter(
2
    model="gpt-4o",
3
    role="Editor",
4
    goal="Ensure content quality through careful review and refinement",
5
    backstory="""You are an experienced editor with a keen eye for detail
6
    and a passion for quality. You excel at polishing content while
7
    maintaining the writer's voice, catching errors, improving clarity,
8
    and ensuring the final product meets high standards.
9
10
    When working with the crew:
11
    - Review drafts from the Content Writer
12
    - Check for accuracy, clarity, and consistency
13
    - Suggest improvements and catch errors
14
    - Provide the final polished version to the user""",
15
    custom_section="""
16
Your workflow:
17
1. Review drafts from @Content Writer
18
2. Check for grammar, clarity, and flow
19
3. Verify accuracy against research from @Research Analyst
20
4. Provide the final polished content to the user
21
5. If major issues found, send back to writer with feedback
22
""",
23
)

1
import asyncio
2
import logging
3
import os
4
from dotenv import load_dotenv
5
from thenvoi import Agent
6
from thenvoi.adapters import CrewAIAdapter
7
from thenvoi.config import load_agent_config
8
9
# Configure logging
10
logging.basicConfig(
11
    level=logging.WARNING,
12
    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
13
    datefmt="%Y-%m-%d %H:%M:%S",
14
)
15
logging.getLogger("thenvoi").setLevel(logging.INFO)
16
logger = logging.getLogger(__name__)
17
18
async def main():
19
    load_dotenv()
20
    agent_id, api_key = load_agent_config("my_agent")
21
22
    adapter = CrewAIAdapter(
23
        model="gpt-4o",
24
        role="Research Assistant",
25
        goal="Help users find, analyze, and synthesize information efficiently",
26
        backstory="""You are an expert research assistant with years of experience
27
        in academic and business research. You excel at finding relevant information,
28
        analyzing data, and presenting findings in a clear, actionable format.
29
        You're known for your attention to detail and ability to connect disparate
30
        pieces of information into meaningful insights.""",
31
        enable_execution_reporting=True,
32
        verbose=True,
33
    )
34
35
    agent = Agent.create(
36
        adapter=adapter,
37
        agent_id=agent_id,
38
        api_key=api_key,
39
        ws_url=os.getenv("THENVOI_WS_URL"),
40
        rest_url=os.getenv("THENVOI_REST_URL"),
41
    )
42
43
    logger.info("Research assistant is running! Press Ctrl+C to stop.")
44
    await agent.run()
45
46
if __name__ == "__main__":
47
    asyncio.run(main())

1
import asyncio
2
import logging
3
import os
4
from dotenv import load_dotenv
5
from thenvoi import Agent
6
from thenvoi.adapters import CrewAIAdapter
7
from thenvoi.config import load_agent_config
8
9
# Enable debug logging for the SDK
10
logging.basicConfig(
11
    level=logging.WARNING,
12
    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
13
    datefmt="%Y-%m-%d %H:%M:%S",
14
)
15
logging.getLogger("thenvoi").setLevel(logging.DEBUG)
16
logger = logging.getLogger(__name__)
17
18
async def main():
19
    load_dotenv()
20
    agent_id, api_key = load_agent_config("my_agent")
21
22
    adapter = CrewAIAdapter(
23
        model="gpt-4o",
24
        verbose=True,
25
    )
26
27
    agent = Agent.create(
28
        adapter=adapter,
29
        agent_id=agent_id,
30
        api_key=api_key,
31
        ws_url=os.getenv("THENVOI_WS_URL"),
32
        rest_url=os.getenv("THENVOI_REST_URL"),
33
    )
34
35
    logger.info("Agent running with DEBUG logging. Press Ctrl+C to stop.")
36
    await agent.run()
37
38
if __name__ == "__main__":
39
    asyncio.run(main())

1
# Good - specific and focused
2
adapter = CrewAIAdapter(
3
    model="gpt-4o",
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-4o",
14
    role="Helper",
15
    goal="Help with stuff",
16
    backstory="You help.",
17
)

1
adapter = CrewAIAdapter(
2
    model="gpt-4o",
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
)

1
adapter = CrewAIAdapter(
2
    model="gpt-4o",
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
)