Agency Swarm Lab

repository·main·Indexed 20 days ago

https://github.com/vrsen/agency-swarm-lab

A showcase repository for custom AI agent teams built using the Agency Swarm framework. It includes implementations such as CodeGuardians Agency for automated code reviews and MetaMarkAgency for Facebook marketing automation. The lab provides guides for integrating third-party API providers via LiteLLM, running local models through Ollama, and deploying the Open Assistant API to bridge open-source models with the Agency Swarm framework.

Tokens
12.1K
Snippets
27
Records
69
Agent score
70%

What's inside agency-swarm-lab

  1. Web Dev Crafters Agency Structure and Agents

    main

    The agency follows a collaborative hierarchy where the CEO communicates with the Designer, who then coordinates with the Web Developer and Copywriter.

    Agent Roles:

    • Designer Agent: Handles UI/UX design and uses browser analysis tools.
    • Web Developer Agent: Manages application development using file system and command tools.
    • Copywriter Agent: Generates website content.
  2. Web Developer Agent Technical Requirements and Constraints

    main

    When acting as the Web Developer Agent, adhere to these technical specifications:

    • Tech Stack: Next.js 14, TypeScript, and Material-UI (MUI).
    • Directory Structure: Must use src and pages directories.
    • Styling:
      • You must explicitly define background and text colors for the web page.
      • The design should be complex, stylish, and professional (avoid simple designs).
      • Use images provided by the user for each section of the website.
    • Error Handling: If a command results in an error, you must attempt to resolve it immediately. Do not proceed until the error is fixed. If you get stuck while modifying a file, use the ComponentCreatorTool to rewrite the entire file.
  3. Understand the MetaMarkAgency agent structure

    main

    The agency is composed of three specialized agents that work together to manage Facebook marketing:

    • Ad Copy Agent: Responsible for generating compelling ad copy tailored to specific campaign goals.
    • Image Creator Agent: Uses DALL-E 3 to generate visual assets that complement the ad copy.
    • Facebook Manager Agent: Manages the technical execution on Facebook, including creating campaigns, ad sets, and posting ads.
  4. Role and responsibilities of the Copywriter agent

    main

    The Copywriter agent is a specialized member of the WebDevCrafters agency. Its primary purpose is to generate engaging, effective content specifically tailored for web applications.

    Key Responsibilities:

    • Generating website content such as headlines, product descriptions, and promotional material.
    • Collaborating with the Web Developer agent to ensure content is correctly integrated into the application structure.
    • Analyzing target audiences to ensure content drives engagement.
  5. Role and responsibilities of the GenesisCEO agent

    main

    The GenesisCEO agent acts as the central orchestrator for the WebDevCrafters agency. Its primary purpose is to oversee agency operations, align all agents with the agency's mission, and facilitate collaboration between specialized roles.

    Core Responsibilities:

    • Communication Orchestration: Establishing and maintaining clear communication channels between all agents.
    • Mission Alignment: Ensuring all agents understand and work toward the agency's goals.
    • Workflow Facilitation: Managing the handoffs and collaboration between the Designer, Web Developer, and Copywriter to ensure a cohesive web development process.
  6. How the ImageCreatorAgent functions

    main

    The ImageCreatorAgent is a specialized agent designed to generate visual assets using DALL-E 3. Its primary purpose is to ensure that generated images are visually appealing and strictly synchronized with the provided ad copy.

    Workflow:

    1. Input: It receives ad copy and specific thematic or visual requests from an AdCopyAgent.
    2. Generation: It uses DALL-E 3 to create images based on that copy and the requested themes.
    3. Refinement: It reviews the output and makes adjustments to ensure alignment with the ad copy and visual requirements.
    4. Output: It notifies the user when the images are ready for the subsequent stages of the advertising campaign.
  7. Understand the responsibilities of CodeAnalyzerCodeGuardiansAgency

    main

    The CodeAnalyzerCodeGuardiansAgency agent is a quality assurance specialist designed for TypeScript codebases. Its primary workflow involves:

    1. Retrieving Changes: Using the GitHub API to fetch changes from relevant pull requests.
    2. Analyzing Code: Evaluating the retrieved changes against specific quality standards.
    3. Reporting: Passing findings to the ReportGeneratorCodeGuardiansAgency for final report compilation.
  8. Operational guidelines for the Browsing Agent

    main

    The Browsing Agent is designed to navigate and search the web using specialized tools. To ensure successful task completion, follow these operational constraints:

    • URL Navigation: Never guess direct URLs. Always perform a Google search or return to previous search results to find links.
    • Link Interaction: When moving to a new page, always use the ClickElement tool to open links rather than attempting to navigate via URL.
    • Single Page Constraint: The agent can only interact with one web page at a time. Complete all analysis or interactions on the current page before attempting to move to a different source.
    • Information Extraction: Use AnalyzeContent for visible content analysis or locating elements. Use ExportFile for full-page content analysis.
  9. Understand the MetaMark Agency structure and agent roles

    main

    The MetaMark Agency is an automated workflow designed to generate and post Facebook advertisements. It uses a sequential communication flow where agents pass tasks to one another to ensure cohesive ad creation. The agency consists of four specialized roles:

    1. GenesisCEO: The orchestrator. It oversees the entire operation, manages the workflow between agents, and ensures agency goals are met.
    2. AdCopyAgent: The creative writer. It analyzes target audiences and product features to generate compelling ad copy using AI text generation tools.
    3. ImageCreatorAgent: The visual designer. It uses the DALL-E 3 API to generate images that are visually synchronized with the provided ad copy.
    4. FacebookManagerAgent: The publisher. It manages the scheduling and posting of ads to Facebook using the Facebook Graph API, following best practices for timing and targeting.