Agency Swarm Lab
repository·main·Indexed 20 days ago
https://github.com/vrsen/agency-swarm-labA 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.
What's inside agency-swarm-lab
- CodeGuardiansAgency is an automated agency designed to maintain TypeScript codebase quality. It achieves this by analyzing GitHub pull request changes, verifying adherence to coding standards, and generating comprehensive quality reports.
Overview of MetaMarkAgency
mainMetaMarkAgency is an automated Facebook marketing agency built on the Agency Swarm framework. It uses specialized AI agents to automate different stages of the marketing lifecycle, including copy generation, image creation, and post management.Overview of the ProjectManagementAgency Mission
mainThe
ProjectManagementAgencyis designed to streamline project management workflows by automating interactions with Notion. Its primary functions are:- Automated Retrieval: Fetching project overviews directly from Notion.
- Automated Posting: Automatically posting backlog tasks into specific Notion project pages.
Web Dev Crafters Agency Structure and Agents
mainThe 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.
Web Developer Agent Technical Requirements and Constraints
mainWhen 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
srcandpagesdirectories. - 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
ComponentCreatorToolto rewrite the entire file.
Understand the MetaMarkAgency agent structure
mainThe 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.
Role and responsibilities of the Copywriter agent
mainThe Copywriter agent is a specialized member of the
WebDevCraftersagency. 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.
Role and responsibilities of the GenesisCEO agent
mainThe
GenesisCEOagent 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.
How the ImageCreatorAgent functions
mainThe
ImageCreatorAgentis 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:
- Input: It receives ad copy and specific thematic or visual requests from an
AdCopyAgent. - Generation: It uses DALL-E 3 to create images based on that copy and the requested themes.
- Refinement: It reviews the output and makes adjustments to ensure alignment with the ad copy and visual requirements.
- Output: It notifies the user when the images are ready for the subsequent stages of the advertising campaign.
- Input: It receives ad copy and specific thematic or visual requests from an
Understand the responsibilities of CodeAnalyzerCodeGuardiansAgency
mainThe
CodeAnalyzerCodeGuardiansAgencyagent is a quality assurance specialist designed for TypeScript codebases. Its primary workflow involves:- Retrieving Changes: Using the GitHub API to fetch changes from relevant pull requests.
- Analyzing Code: Evaluating the retrieved changes against specific quality standards.
- Reporting: Passing findings to the
ReportGeneratorCodeGuardiansAgencyfor final report compilation.
Operational guidelines for the Browsing Agent
mainThe 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
ClickElementtool 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
AnalyzeContentfor visible content analysis or locating elements. UseExportFilefor full-page content analysis.
Understand the MetaMark Agency structure and agent roles
mainThe 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:
- GenesisCEO: The orchestrator. It oversees the entire operation, manages the workflow between agents, and ensures agency goals are met.
- AdCopyAgent: The creative writer. It analyzes target audiences and product features to generate compelling ad copy using AI text generation tools.
- ImageCreatorAgent: The visual designer. It uses the DALL-E 3 API to generate images that are visually synchronized with the provided ad copy.
- 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.