Perplexity Spaces로 팀 리서치 허브 만들기: 소스 공유부터 협업 워크플로우까지 완벽 가이드
Perplexity Spaces로 팀 리서치 허브 만들기
Perplexity Spaces는 팀이 AI 기반 리서치를 공동으로 수행할 수 있는 협업 환경입니다. 소스 컬렉션 공유, 프롬프트 저장, 역할 기반 접근 제어까지 지원하여 분산된 리서치 작업을 하나의 허브로 통합할 수 있습니다. 이 가이드에서는 실무에서 바로 활용할 수 있는 팀 리서치 허브 구축 방법을 단계별로 안내합니다.
사전 준비 사항
- Perplexity Pro 또는 Enterprise 구독 (Spaces 기능 활성화 필요)- 팀원 각각의 Perplexity 계정- Perplexity API 키 (자동화 워크플로우 구성 시 필요)
API 키 발급 및 환경 설정
# Perplexity API 키 환경변수 설정 (Linux/macOS)
export PERPLEXITY_API_KEY=“YOUR_API_KEY”
Windows PowerShell
$env:PERPLEXITY_API_KEY=“YOUR_API_KEY”
API 연결 테스트
curl -s https://api.perplexity.ai/chat/completions
-H “Authorization: Bearer $PERPLEXITY_API_KEY”
-H “Content-Type: application/json”
-d ’{“model”:“sonar-pro”,“messages”:[{“role”:“user”,“content”:“test”}]}’
| head -c 200
Step 1: Space 생성 및 기본 구조 설계
- Perplexity 대시보드 좌측 사이드바에서 Spaces 클릭- Create Space 버튼을 선택하여 새 Space 생성- Space 이름을 팀 목적에 맞게 설정 (예:
Q2-시장분석-리서치)- 설명(Description)에 Space의 목적과 사용 규칙을 명시Space 구조를 체계적으로 설계하면 팀원들이 빠르게 적응할 수 있습니다. 다음과 같은 네이밍 컨벤션을 추천합니다.
| Space 유형 | 네이밍 패턴 | 예시 |
|---|---|---|
| 프로젝트별 | [분기]-[프로젝트명]-리서치 | Q2-신제품출시-리서치 |
| 부서별 | [부서명]-[주제]-허브 | 마케팅-경쟁사분석-허브 |
| 고객별 | [고객코드]-[업무]-Space | CLT042-기술검토-Space |
# API를 통한 소스 기반 질의 자동화 스크립트
import requests
import json
API_KEY = “YOUR_API_KEY”
HEADERS = {
“Authorization”: f”Bearer {API_KEY}”,
“Content-Type”: “application/json”
}
def query_with_context(question, focus=“internet”):
payload = {
“model”: “sonar-pro”,
“messages”: [
{
“role”: “system”,
“content”: “당신은 시장 리서치 전문가입니다. 한국어로 답변하세요.”
},
{
“role”: “user”,
“content”: question
}
],
“search_focus”: focus,
“return_citations”: True
}
response = requests.post(
“https://api.perplexity.ai/chat/completions”,
headers=HEADERS,
json=payload
)
result = response.json()
answer = result[“choices”][0][“message”][“content”]
citations = result.get(“citations”, [])
return answer, citations
사용 예시
answer, sources = query_with_context(
“2025년 한국 SaaS 시장 트렌드와 주요 플레이어를 분석해줘”
)
print(answer)
print(“\n참고 소스:”)
for src in sources:
print(f” - {src}“)
Step 3: 프롬프트 템플릿 저장 및 재활용
반복적인 리서치 질문을 프롬프트 템플릿으로 저장하면 팀 전체의 리서치 품질을 균일하게 유지할 수 있습니다.
- Space 내에서 자주 사용하는 질문 패턴을 **Custom Instructions**에 등록- System Prompt를 설정하여 Space 전체에 적용되는 맥락을 지정- 팀원들이 동일한 프롬프트 프레임워크를 사용하도록 공유# 팀 프롬프트 템플릿 관리 스크립트 (JSON 파일 기반)
import json
from pathlib import Path
TEMPLATE_FILE = “team_prompts.json”
def save_template(name, system_prompt, user_prompt_template):
templates = {}
if Path(TEMPLATE_FILE).exists():
with open(TEMPLATE_FILE, “r”, encoding=“utf-8”) as f:
templates = json.load(f)
templates[name] = {
“system”: system_prompt,
“user_template”: user_prompt_template
}
with open(TEMPLATE_FILE, “w”, encoding=“utf-8”) as f:
json.dump(templates, f, ensure_ascii=False, indent=2)
print(f”템플릿 ‘{name}’ 저장 완료”)
경쟁사 분석 템플릿 등록
save_template(
“competitor_analysis”,
“당신은 B2B SaaS 시장 분석 전문가입니다. 데이터 기반으로 분석하세요.”,
“{company_name}의 최근 제품 전략, 가격 정책, 시장 포지셔닝을 분석해주세요. ”
“특히 {focus_area} 측면에서 심층 비교해주세요.”
)
Step 4: 팀원 초대 및 역할 설정
- Space 설정에서 Members 탭 진입- Invite를 클릭하고 팀원 이메일 입력- 역할 지정: Viewer(읽기 전용), Contributor(질의 및 소스 추가), Admin(전체 관리)
역할 질의 실행 소스 추가 멤버 관리 Space 설정 Viewer O X X X Contributor O O X X Admin O O O O
Step 5: 협업 워크플로우 자동화
API를 활용하면 정기 리서치 보고서를 자동으로 생성하고 팀에 공유할 수 있습니다.
# 주간 리서치 자동화 워크플로우
import requests
import json
from datetime import datetime
API_KEY = “YOUR_API_KEY”
TOPICS = [
“AI 규제 동향 한국”,
“클라우드 보안 시장 변화”,
“SaaS 가격 전략 트렌드”
]
def generate_weekly_report(topics):
report_sections = []
for topic in topics:
payload = {
“model”: “sonar-pro”,
“messages”: [
{“role”: “system”, “content”: “간결한 시장 브리핑을 작성하세요. 3-5개 핵심 포인트로 요약.”},
{“role”: “user”, “content”: f”최근 1주일간 ‘{topic}’ 관련 주요 변화를 요약해줘”}
],
“return_citations”: True
}
resp = requests.post(
“https://api.perplexity.ai/chat/completions”,
headers={“Authorization”: f”Bearer {API_KEY}”, “Content-Type”: “application/json”},
json=payload
)
data = resp.json()
content = data[“choices”][0][“message”][“content”]
report_sections.append(f”## {topic}\n{content}\n”)
date_str = datetime.now().strftime("%Y-%m-%d")
report = f"# 주간 리서치 브리핑 ({date_str})\n\n" + "\n".join(report_sections)
filename = f"weekly_report_{date_str}.md"
with open(filename, "w", encoding="utf-8") as f:
f.write(report)
print(f"리포트 생성 완료: {filename}")
return filename
generate_weekly_report(TOPICS)
Pro Tips: 파워 유저를 위한 고급 활용법
- Focus 모드 활용: 학술 논문만 검색하려면
search_focus: “scholar”를, 최신 뉴스는“news”를 지정하세요.- System Prompt 계층화: Space 레벨 기본 지시사항 위에 개별 쓰레드에서 추가 맥락을 덧붙이면 일관성과 유연성을 동시에 확보합니다.- 소스 우선순위 지정: 내부 문서를 업로드한 뒤 “이 문서를 우선 참조하여 답변해줘”라는 지시를 추가하면 외부 정보보다 내부 지식이 우선 반영됩니다.- CI/CD 연동: GitHub Actions 또는 cron job으로 위 자동화 스크립트를 주기적으로 실행하고, 결과를 Slack Webhook으로 팀 채널에 자동 전송하세요.- 멀티 Space 전략: 프로젝트 단위로 Space를 분리하되, “팀 지식 베이스” Space를 별도로 운영하여 장기 레퍼런스를 축적하세요.
Troubleshooting: 자주 발생하는 문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
401 Unauthorized 에러 | API 키 만료 또는 오타 | Perplexity 설정 > API Keys에서 키를 재발급하고 환경변수를 업데이트하세요 |
| Space에 초대한 팀원이 접근 불가 | 구독 플랜 제한 | Pro 플랜에서 최대 멤버 수를 확인하고, Enterprise로 업그레이드를 검토하세요 |
| 업로드한 파일이 검색에 반영 안 됨 | 파일 인덱싱 지연 | 파일 업로드 후 1-2분 대기하세요. PDF의 경우 OCR 처리 시간이 추가될 수 있습니다 |
429 Rate Limit 에러 | API 호출 한도 초과 | 요청 간 딜레이를 추가하거나 time.sleep(2)로 간격을 조절하세요 |
| 답변에 소스가 누락됨 | return_citations 미설정 | API 호출 시 "return_citations": true 파라미터를 반드시 포함하세요 |
Q1: Perplexity Spaces는 무료 플랜에서도 사용할 수 있나요?
Spaces 기능은 Perplexity Pro 이상 구독에서 제공됩니다. 무료 플랜에서는 개인 검색만 가능하며, 팀 협업 기능인 멤버 초대, 소스 공유, Custom Instructions 설정 등은 Pro 또는 Enterprise 플랜이 필요합니다. Enterprise 플랜에서는 추가로 SSO 인증, 감사 로그, 관리자 콘솔 등 보안 관련 기능이 포함됩니다.
Q2: 하나의 Space에 업로드할 수 있는 파일 수와 용량 제한은 어떻게 되나요?
Pro 플랜 기준으로 Space당 최대 50개의 파일을 업로드할 수 있으며, 개별 파일 크기는 25MB 이하여야 합니다. 지원 형식은 PDF, TXT, CSV, DOCX 등입니다. 대용량 자료가 많은 경우 핵심 문서만 선별하여 올리고, 나머지는 URL 링크로 참조하는 방식을 권장합니다. Enterprise 플랜에서는 이 제한이 확대됩니다.
Q3: Space 내 대화 기록과 소스를 외부로 내보낼 수 있나요?
현재 Perplexity는 개별 대화(Thread)를 마크다운 또는 PDF로 내보내기하는 기능을 지원합니다. Space 전체를 일괄 내보내는 기능은 아직 제한적이므로, 중요한 리서치 결과는 위 자동화 스크립트처럼 API를 통해 별도 저장소에 백업하는 워크플로우를 구축하는 것을 권장합니다. Notion, Confluence 등 외부 도구로 연동하려면 API 응답을 파싱하여 해당 플랫폼의 API로 전송하는 중간 스크립트를 작성하세요.