소개
지난번에는 자바스크립트만 활용해서 간단한 카톡봇을 만들어봤습니다. 하지만 이번에는 한 단계 더 나아가 서버 기반의 카톡봇을 구축해보기로 했습니다. 이는 17기 스터디 뉴스레터 과제 중 하나로, 퍼플렉시티 API와 FastAPI(Python) 를 활용해 카카오톡과 실시간으로 대화할 수 있는 봇을 만드는 실험이었습니다.
진행 방법
🔧 사전 준비
퍼플렉시티 API Key 발급
중고 안드로이드폰 구입 및 새로운 카카오계정 생성
메신저봇 설치 및 연동
디지털오션(DigitalOcean) 가입 및 서버 생성
🛠 사용 도구 및 활용법
퍼플렉시티 API: 사용자 질문에 대한 AI 응답 생성
FastAPI (Python): REST API 서버 구성 및 라우팅 처리
디지털오션: FastAPI 서버를 클라우드에 배포하여 항상 응답 가능하도록 유지
메신저봇: 카카오톡 메시지 송수신 인터페이스 역할
안드로이드폰 + 새 카카오계정: 실사용 테스트용 장비 및 계정 세팅
🛠 과정
디지털오션 - fast API 시스템 등록하기
우측, 콘솔을 클릭
아래와 같이 콘솔 화면이 나옵니다.
서비스파일 생성 (예시)
서비스 리로드 -> 시작 -> 자동실행 -> 상태확인 (될 때까지 반복하기)
메신져봇 파이썬 코드
"""
FastAPI 기반 Perplexity 검색 서버
"""
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
import httpx
import os
from dotenv import load_dotenv
# 환경변수 로딩
load_dotenv()
PERPLEXITY_API_KEY = os.getenv("PERPLEXITY_API_KEY")
app = FastAPI(title="Perplexity 검색 서버")
API_TIMEOUT = 30 # 초
class SearchRequest(BaseModel):
query: str
class SearchResponse(BaseModel):
answer: str
# Perplexity API 호출 함수
async def call_perplexity(query: str) -> str:
headers = {
"Authorization": f"Bearer {PERPLEXITY_API_KEY}",
"Content-Type": "application/json"
}
data = {
"model": "sonar-pro",
"messages": [{"role": "user", "content": query}]
}
try:
async with httpx.AsyncClient() as client:
response = await client.post(
"https://api.perplexity.ai/chat/completions",
headers=headers,
json=data,
timeout=API_TIMEOUT
)
if response.status_code == 200:
result = response.json()
return result.get("choices", [{}])[0].get("message", {}).get("content", "응답 없음")
else:
return f"❌ API 오류: HTTP {response.status_code}"
except httpx.TimeoutException:
return "⏱️ 요청 시간이 초과되었습니다."
except Exception as e:
return f"❌ 예외 발생: {str(e)}"
@app.post("/search", response_model=SearchResponse)
async def search(request: SearchRequest):
if not PERPLEXITY_API_KEY:
raise HTTPException(status_code=500, detail="API 키가 설정되지 않았습니다.")
answer = await call_perplexity(request.query)
return SearchResponse(answer=answer)
@app.get("/")
async def health_check():
return {"status": "ok", "service": "Perplexity 검색 서버"}
퍼플랙시티 카톡봇 응답결과
결과와 배운 점
퍼플렉시티 기반 카톡봇은 약간 반박자 느린 응답이지만, 실시간 대화에는 큰 무리가 없었습니다 👍
서버 셋업과 파일등록 과정은 초보에게는 쉽지 않았지만, 레오님의 도움으로 무사히 구축 완료했습니다 🙏
기술적인 문제보다도 ‘같이 하는 사람’의 중요성을 다시금 느낄 수 있었던 프로젝트였습니다.
이번 성공을 바탕으로 다음 과제는 '카톡 요약봇' 도전 예정입니다!
도움 받은 글
복받어 현우님 2주차 강의 교안
독자에게 한마디
혼자 하지 말고 함께 하세요! 💬
같이 하면 막막한 서버 설치도, 버그 해결도 한결 수월해집니다 😊혼자 했으면 성공하지 못 했을텐데 '레오님' 도움으로 복잡했던 서버 설치를 마칠 수 있었습니다.
옆에서 도와주는 사람의 중요성과 너무 감사하다고 마음입니다.
이번 기수 스터디가 끝나기 전에 카톡요약봇 만들기도 성공해보겠습니다.