swarms/swarms/notes.md

# 10 improvements to the `Orchestrator` class to enable more flexibility and usability:

1.  Dynamic Agent Creation: Allow the number of agents to be specified at runtime, rather than being fixed at the time of instantiation.

```
def add_agents(self, num_agents: int):
    for _ in range(num_agents):
        self.agents.put(self.agent())
    self.executor = ThreadPoolExecutor(max_workers=self.agents.qsize())
```

1.  Agent Removal: Allow agents to be removed from the pool.

```
def remove_agents(self, num_agents: int):
    for _ in range(num_agents):
        if not self.agents.empty():
            self.agents.get()
    self.executor = ThreadPoolExecutor(max_workers=self.agents.qsize())
```

1.  Task Prioritization: Allow tasks to be prioritized.

```
from queue import PriorityQueue

def __init__(self, agent, agent_list: List[Any], task_queue: List[Any], collection_name: str = "swarm", api_key: str = None, model_name: str = None):
    # ...
    self.task_queue = PriorityQueue()
    # ...

def add_task(self, task: Dict[str, Any], priority: int = 0):
    self.task_queue.put((priority, task))
```

1.  Task Status: Track the status of tasks.

```
from enum import Enum

class TaskStatus(Enum):
    QUEUED = 1
    RUNNING = 2
    COMPLETED = 3
    FAILED = 4

# In assign_task method
self.current_tasks[id(task)] = TaskStatus.RUNNING
# On successful completion
self.current_tasks[id(task)] = TaskStatus.COMPLETED
# On failure
self.current_tasks[id(task)] = TaskStatus.FAILED
```

1.  Result Retrieval: Allow results to be retrieved by task ID.

```
def retrieve_result(self, task_id: int) -> Any:
    return self.collection.query(query_texts=[str(task_id)], n_results=1)
```

1.  Batch Task Assignment: Allow multiple tasks to be assigned at once.

```
def assign_tasks(self, tasks: List[Dict[str, Any]]):
    for task in tasks:
        self.task_queue.put(task)
```

1.  Error Handling: Improve error handling by re-queuing failed tasks.

```
# In assign_task method
except Exception as error:
    logging.error(f"Failed to process task {id(task)} by agent {id(agent)}. Error: {error}")
    self.task_queue.put(task)
```

1.  Agent Status: Track the status of agents (e.g., idle, working).

```
self.agent_status = {id(agent): "idle" for agent in self.agents.queue}

# In assign_task method
self.agent_status[id(agent)] = "working"
# On task completion
self.agent_status[id(agent)] = "idle"
```

1.  Custom Embedding Function: Allow a custom embedding function to be used.

```
def __init__(self, agent, agent_list: List[Any], task_queue: List[Any], collection_name: str = "swarm", api_key: str = None, model_name: str = None, embed_func=None):
    # ...
    self.embed_func = embed_func if embed_func else self.embed
    # ...

def embed(self, input, api_key, model_name):
    # ...
    embedding = self.embed_func(input)
    # ...
```

1.  Agent Communication: Allow agents to communicate with each other.

```
def communicate(self, sender_id: int, receiver_id: int, message: str):
    message_vector = self.embed_func(message)
    self.collection.add(embeddings=[message_vector], documents=[message], ids=[f"{sender_id}_to_{receiver_id}"])
```



```
import logging
import queue
import threading
from concurrent.futures import ThreadPoolExecutor
from typing import Any, Dict, List
from enum import Enum

import chromadb
from chromadb.utils import embedding_functions

class TaskStatus(Enum):
    QUEUED = 1
    RUNNING = 2
    COMPLETED = 3
    FAILED = 4

class Orchestrator:
    def __init__(self, agent, agent_list: List[Any], task_queue: List[Any], collection_name: str = "swarm", api_key: str = None, model_name: str = None, embed_func=None):
        self.agent = agent
        self.agents = queue.Queue()
        self.agent_status = {}

        self.add_agents(agent_list)

        self.task_queue = queue.PriorityQueue()

        self.chroma_client = chromadb.Client()

        self.collection = self.chroma_client.create_collection(name = collection_name)

        self.current_tasks = {}

        self.lock = threading.Lock()
        self.condition = threading.Condition(self.lock)

        self.embed_func = embed_func if embed_func else self.embed

    def add_agents(self, num_agents: int):
        for _ in range(num_agents):
            agent = self.agent()
            self.agents.put(agent)
            self.agent_status[id(agent)] = "idle"
        self.executor = ThreadPoolExecutor(max_workers=self.agents.qsize())

    def remove_agents(self, num_agents: int):
        for _ in range(num_agents):
            if not self.agents.empty():
                agent = self.agents.get()
                del self.agent_status[id(agent)]
        self.executor = ThreadPoolExecutor(max_workers=self.agents.qsize())

    def assign_task(self, agent_id: int, task: Dict[str, Any]) -> None:
        while True:
            with self.condition:
                while not self.task_queue:
                    self.condition.wait()
                agent = self.agents.get()
                task = self.task_queue.get()

            try:
                self.agent_status[id(agent)] = "working"
                result = self.worker.run(task["content"])

                vector_representation = self.embed_func(result)

                self.collection.add(embeddings=[vector_representation], documents=[str(id(task))], ids=[str(id(task))])

                logging.info(f"Task {id(str)} has been processed by agent {id(agent)} with")
                self.current_tasks[id(task)] = TaskStatus.COMPLETED

            except Exception as error:
                logging.error(f"Failed to process task {id(task)} by agent {id(agent)}. Error: {error}")
                self.current_tasks[id(task)] = TaskStatus.FAILED
                self.task_queue.put(task)
            finally:
                with self.condition:
                    self.agent_status[id(agent)] = "idle"
                    self.agents.put(agent)
                    self.condition.notify()

    def embed(self, input):
        openai = embedding_functions.OpenAIEmbeddingFunction(api_key=self.api_key, model_name=self.model_name)
        embedding = openai(input)
        return embedding

    def retrieve_results(self, agent_id: int) -> Any:
        try:
            results = self.collection.query(query_texts=[str(agent_id)], n_results=10)
            return results
        except Exception as e:
            logging.error(f"Failed to retrieve results from agent {id(agent_id)}. Error {e}")
            raise

    def update_vector_db(self, data) -> None:
        try:
            self.collection.add(embeddings=[data["vector"]], documents=[str(data["task_id"])], ids=[str(data["task_id"])])
        except Exception as e:
            logging.error(f"Failed to update the vector database. Error: {e}")
            raise

    def get_vector_db(self):
        return self.collection

    def append_to_db(self, result: str):
        try:
            self.collection.add(documents=[result], ids=[str(id(result))])
        except Exception as e:
            logging.error(f"Failed to append the agent output to database. Error: {e}")
            raise

    def run(self, objective:str):
        if not objective or not isinstance(objective, str):
            logging.error("Invalid objective")
            raise ValueError("A valid objective is required")

        try:
            self.task_queue.put((0, objective))

            results = [self.assign_task(agent_id, task) for agent_id, task in zip(range(len(self.agents)), self.task_queue)]

            for result in results:
                self.append_to_db(result)

            logging.info(f"Successfully ran swarms with results: {results}")
            return results
        except Exception as e:
            logging.error(f"An error occured in swarm: {e}")
            return None

    def chat(self, sender_id: int, receiver_id: int, message: str):
        message_vector = self.embed_func(message)

        # Store the message in the vector database
        self.collection.add(embeddings=[message_vector], documents=[message], ids=[f"{sender_id}_to_{receiver_id}"])

    def assign_tasks(self, tasks: List[Dict[str, Any]], priority: int = 0):
        for task in tasks:
            self.task_queue.put((priority, task))

    def retrieve_result(self, task_id: int) -> Any:
        try:
            result = self.collection.query(query_texts=[str(task_id)], n_results=1)
            return result
        except Exception as e:
            logging.error(f"Failed to retrieve result for task {task_id}. Error: {e}")
            raise
```

With these improvements, the `Orchestrator` class now supports dynamic agent creation and removal, task prioritization, task status tracking, result retrieval by task ID, batch task assignment, improved error handling, agent status tracking, custom embedding functions, and agent communication. This should make the class more flexible and easier to use when creating swarms of LLMs.