Question 1

내 에이전시를 프로덕션에 배포하려면 어떻게 해야 하나요?

Accepted Answer

Dedicated API backend(FastAPI를 추천)에서 authentication 및 thread state를 persist하는 callback 사용이 필요합니다. detailed steps는 Deployment for production guide를 참조해주세요.

Question 2

FastAPI를 사용해서 Agency를 API 형태로 제공하려면 어떻게 해야 하나요?

Accepted Answer

Agency를 FastAPI 엔드포인트에 삽입합니다:
```python
from fastapi import FastAPI
from uuid import uuid4

app = FastAPI()

@app.post("/chat")
async def chat(user_request: UserRequest):
    chat_id = user_request.chat_id or str(uuid4())
    agency = Agency(
        agent,
        load_threads_callback=lambda: load_threads(chat_id),
        save_threads_callback=lambda thread_dict: save_threads(thread_dict, chat_id)
    )
    response = await agency.get_response(user_request.message)
    return {"chat_id": chat_id, "response": response.final_output}
```
또는 내장된 FastAPI 통합을 사용합니다:
```python
agency.run_fastapi(host="0.0.0.0", port=8000)
```

Question 3

CodeInterpreter tool이 자동으로 추가 된 이유는?

Accepted Answer

.json, .docx, .pptx 등 특정 파일 형식을 업로드 할 경우 CodeInterpreter tool 이 자동으로 추가됩니다. 이와 같은 동작 경로를 변경하고 싶다면 agent의 지시를 업데이트하거나 custom file-handling tool을 만들어야 할 것입니다.

Question 4

Agency Swarm agency tool 간의 데이터를 전송하는 방법은?

Accepted Answer

Agency Swarm agency tool 간의 데이터를 전송하는 방법은?

Agency Swarm agency tool 간의 데이터를 전송하는 방법은 2가지가 있습니다. 첫 번째는 agency context 를 tool 내에 포함시키는 것입니다. 두 번째 방법은 파일을 cloud storage 로 업로드 한 뒤 file id 를 발행하는 것을 추천합니다. 다른 tool 이나 agent 가 file id 를 이용할 수 있습니다.

Asked by Joanna Kowalski · Oct 20, 2025

Question 5

Agency Swarm 에서 여러 사용자 관리는 어떻게 하나요?

Accepted Answer

여러 사용자 또는 채팅을 지원하려면, 각 사용자의 데이터베이스에서 thread ID를 로드하고 저장하는게 필요합니다. 각 채팅/사용자가 고유한 thread ID를 보유하고 Production으로 Deploy 하는 것을 참조하는 Deployment to Production 가이드를 참조하세요.

Question 6

Agency Swarm 의 대화 기록을 저장하고 계속 사용하려면 어떻게 해야 하나요?

Accepted Answer

대화 기록을 다시 시작할 때 계속 사용하려면, 지역 파일에서 전채 메시지 이력 전체를 저장하고 다시 불러 오는 callback 함수를 구현하세요. 예를 들어, callback 함수들 정의하세요:
```python
import os, json

def load_threads(chat_id: str) -> list[dict]: 
 """Load all threads data for a specific chat session."""
 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(thread_dict: list[dict], chat_id: str): 
 """Save all threads data to file."""
 with open(f"{chat_id}_threads.json", "w") as file: 
 json.dump(thread_dict, file)
``` 
 Agency 초기화 시에 이 callback 함수들을 건네세요:
```python
from agency_swarm import Agency
Agency = Agency( 
 agent,  load_threads_callback=lambda: load_threads(chat_id),
 save_threads_callback=lambda thread_dict : save_threads(thread_dict, chat_id),
 )
``` 
 이런 구현으로 대화 컨텍스트를 여러 번 실행할 때 유지됩니다.

Question 7

Agency Swarm에서는 open source models를 사용할 수 있는가요?

Accepted Answer

네-간단한 비즈니스에 사용할 수 있습니다-주로 하나 또는 두 개의 도구가 포함된 경우 (그리고 그 도구를 제외한 경우), 추가 정보를 참조하여 더 자세히 보세요.

Question 8

Agency Swarm에서 OpenAI API 키를 어떻게 설정해야하는가요?

Accepted Answer

API 키를 코드에 세팅하세요: `python from agency_swarm import set_openai_key set_openai_key("YOUR_API_KEY")` 또는 .env 파일을 사용하세요: `OPENAI_API_KEY=sk-1234...`, 이 파일을 로드하세요: `python from dotenv import load_dotenv load_dotenv()`