FAQ

Set your API key in your code:

from agency_swarm import set_openai_key
set_openai_key("YOUR_API_KEY")

Or use a .env file:

OPENAI_API_KEY=sk-1234...

Then load it with:

from dotenv import load_dotenv
load_dotenv()

To persist threads between application restarts, implement thread callbacks that save and load thread IDs from a local file. For example, define your callback functions:

import os
import json

def load_threads(chat_id):
    if os.path.exists(f"{chat_id}_threads.json"):
        with open(f"{chat_id}_threads.json", "r") as file:
            return json.load(file)
    return []

def save_threads(new_threads, chat_id):
    with open(f"{chat_id}_threads.json", "w") as file:
        json.dump(new_threads, file)

Then, pass these callbacks during your agency initialization to resume conversations:

from agency_swarm.agency.genesis import GenesisAgency

agency = GenesisAgency(
    ...
    threads_callbacks={
        'load': lambda: load_threads(chat_id),
        'save': lambda new_threads: save_threads(new_threads, chat_id)
    }
)

This setup preserves your conversation context between runs.

Embed your agency within a FastAPI endpoint. For example:

@app.post("/chat")
async def chat(user_request: UserRequest):
    chat_id = user_request.chat_id or str(uuid4())
    agency = Agency([...],
        threads_callbacks={
            'load': lambda: load_threads(chat_id),
            'save': lambda new_threads: save_threads(new_threads, chat_id)
        })
    response = agency.get_completion(user_request.message)
    return {"chat_id": chat_id, "response": response}

Welcome

Core Framework

Additional Features

Contributing

FAQ

Getting Support

Community Support

Professional Services