Kye Gomez
2 days ago
parent
cc6bfed4be
commit
5343590656
@ -0,0 +1,135 @@
|
||||
## Interactive Groupchat Examples
|
||||
|
||||
The Interactive GroupChat is a powerful multi-agent architecture that enables dynamic collaboration between multiple AI agents. This architecture allows agents to communicate with each other, respond to mentions using `@agent_name` syntax, and work together to solve complex tasks through structured conversation flows.
|
||||
|
||||
### Architecture Description
|
||||
|
||||
The Interactive GroupChat implements a **collaborative swarm architecture** where multiple specialized agents work together in a coordinated manner. Key features include:
|
||||
|
||||
- **Mention-based Communication**: Agents can be directed to specific tasks using `@agent_name` syntax
|
||||
- **Flexible Speaker Functions**: Multiple speaking order strategies (round robin, random, priority-based)
|
||||
- **Enhanced Collaboration**: Agents build upon each other's responses and avoid redundancy
|
||||
- **Interactive Sessions**: Support for both automated and interactive conversation modes
|
||||
- **Context Awareness**: Agents maintain conversation history and context
|
||||
|
||||
For comprehensive documentation on Interactive GroupChat, visit: [Interactive GroupChat Documentation](https://docs.swarms.world/en/latest/swarms/structs/interactive_groupchat/)
|
||||
|
||||
### Step-by-Step Showcase
|
||||
|
||||
* **Agent Creation**: Define specialized agents with unique expertise and system prompts
|
||||
* **GroupChat Initialization**: Create the InteractiveGroupChat structure with desired speaker function
|
||||
* **Task Definition**: Formulate tasks using `@agent_name` mentions to direct specific agents
|
||||
* **Execution**: Run the group chat to generate collaborative responses
|
||||
* **Response Processing**: Handle the coordinated output from multiple agents
|
||||
* **Iteration**: Chain multiple tasks for complex workflows
|
||||
|
||||
## Installation
|
||||
|
||||
Install the swarms package using pip:
|
||||
|
||||
```bash
|
||||
pip install -U swarms
|
||||
```
|
||||
|
||||
## Basic Setup
|
||||
|
||||
1. First, set up your environment variables:
|
||||
|
||||
```python
|
||||
WORKSPACE_DIR="agent_workspace"
|
||||
OPENAI_API_KEY=""
|
||||
```
|
||||
|
||||
## Code
|
||||
|
||||
```python
|
||||
"""
|
||||
InteractiveGroupChat Speaker Function Examples
|
||||
|
||||
This example demonstrates how to use different speaker functions in the InteractiveGroupChat:
|
||||
- Round Robin: Agents speak in a fixed order, cycling through the list
|
||||
- Random: Agents speak in random order
|
||||
- Priority: Agents speak based on priority weights
|
||||
- Custom: User-defined speaker functions
|
||||
|
||||
The example also shows how agents can mention each other using @agent_name syntax.
|
||||
"""
|
||||
|
||||
from swarms import Agent
|
||||
from swarms.structs.interactive_groupchat import (
|
||||
InteractiveGroupChat,
|
||||
random_speaker,
|
||||
)
|
||||
|
||||
|
||||
def create_example_agents():
|
||||
"""Create example agents for demonstration."""
|
||||
|
||||
# Create agents with different expertise
|
||||
analyst = Agent(
|
||||
agent_name="analyst",
|
||||
system_prompt="You are a data analyst. You excel at analyzing data, creating charts, and providing insights.",
|
||||
model_name="gpt-4.1",
|
||||
streaming_on=True,
|
||||
print_on=True,
|
||||
)
|
||||
|
||||
researcher = Agent(
|
||||
agent_name="researcher",
|
||||
system_prompt="You are a research specialist. You are great at gathering information, fact-checking, and providing detailed research.",
|
||||
model_name="gpt-4.1",
|
||||
streaming_on=True,
|
||||
print_on=True,
|
||||
)
|
||||
|
||||
writer = Agent(
|
||||
agent_name="writer",
|
||||
system_prompt="You are a content writer. You excel at writing clear, engaging content and summarizing information.",
|
||||
model_name="gpt-4.1",
|
||||
streaming_on=True,
|
||||
print_on=True,
|
||||
)
|
||||
|
||||
return [analyst, researcher, writer]
|
||||
|
||||
|
||||
def example_random():
|
||||
agents = create_example_agents()
|
||||
|
||||
# Create group chat with random speaker function
|
||||
group_chat = InteractiveGroupChat(
|
||||
name="Random Team",
|
||||
description="A team that speaks in random order",
|
||||
agents=agents,
|
||||
speaker_function=random_speaker,
|
||||
interactive=False,
|
||||
)
|
||||
|
||||
# Test the random behavior
|
||||
task = "Let's create a marketing strategy. @analyst @researcher @writer please contribute."
|
||||
|
||||
response = group_chat.run(task)
|
||||
print(f"Response:\n{response}\n")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
# example_round_robin()
|
||||
example_random()
|
||||
```
|
||||
|
||||
|
||||
|
||||
## Connect With Us
|
||||
|
||||
Join our community of agent engineers and researchers for technical support, cutting-edge updates, and exclusive access to world-class agent engineering insights!
|
||||
|
||||
| Platform | Description | Link |
|
||||
|----------|-------------|------|
|
||||
| 📚 Documentation | Official documentation and guides | [docs.swarms.world](https://docs.swarms.world) |
|
||||
| 📝 Blog | Latest updates and technical articles | [Medium](https://medium.com/@kyeg) |
|
||||
| 💬 Discord | Live chat and community support | [Join Discord](https://discord.gg/jM3Z6M9uMq) |
|
||||
| 🐦 Twitter | Latest news and announcements | [@kyegomez](https://twitter.com/kyegomez) |
|
||||
| 👥 LinkedIn | Professional network and updates | [The Swarm Corporation](https://www.linkedin.com/company/the-swarm-corporation) |
|
||||
| 📺 YouTube | Tutorials and demos | [Swarms Channel](https://www.youtube.com/channel/UC9yXyitkbU_WSy7bd_41SqQ) |
|
||||
| 🎫 Events | Join our community events | [Sign up here](https://lu.ma/5p2jnc2v) |
|
||||
| 🚀 Onboarding Session | Get onboarded with Kye Gomez, creator and lead maintainer of Swarms | [Book Session](https://cal.com/swarms/swarms-onboarding-session) |
|
||||
Loading…
Reference in new issue