대부분의 AI 튜토리얼은 설정 체크리스트부터 시작합니다. 모델 제공업체를 선택하고, 계정을 만들고, 메모리를 위한 벡터 데이터베이스를 연결해야 합니다. 대화 상태를 유지할 서버를 구축해야 하고, 이 모든 것을 하나로 연결해야 합니다. 그리고 마침내 메시지를 보냅니다.
Backboard는 이 모든 과정을 생략합니다. 단 하나의 API 호출만으로 첫 메시지를 보낼 수 있습니다. 스레드(thread), 어시스턴트(assistant), 메모리, 그리고 수천 개의 모델에 걸친 라우팅이 이미 그 단일 호출 뒤에서 작동하고 있습니다. 사용자가 스택을 조립할 필요가 없습니다. 그것 자체가 스택입니다.
전체 과정은 다음과 같습니다.
1단계: 키 받기
app.backboard.io에 가입하고, 설정(Settings) > API Keys로 이동하여 키를 복사합니다. 신규 계정은 30일 동안 $5의 무료 크레딧을 제공받으며, 신용카드가 필요하지 않습니다.
이것이 유일한 설정입니다. 키는 항상 서버 측에 보관하고, 프론트엔드나 모바일 코드에는 절대 넣지 마세요.
2단계: 메시지 보내기
원하는 언어를 선택하세요. 세 가지 경우 모두 동일한 호출을 사용합니다.
Python
pip install backboard-sdk
import asyncio
from backboard import BackboardClient
...
JavaScript (Node 18+)
설치가 필요 없습니다. fetch만 사용하면 됩니다.
const response = await fetch("https://app.backboard.io/api/threads/messages", {
method: "POST",
headers: {
...
cURL
curl -X POST "https://app.backboard.io/api/threads/messages" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
...
실행합니다. 응답을 받습니다. 이것이 사용자의 첫 AI 메시지입니다.
방금 무슨 일이 일어났나
사용자는 하나의 문자열만 보냈습니다. Backboard가 나머지를 처리했습니다:
- 스레드 생성. 응답의
thread_id는 실시간 대화입니다. 이 ID를 사용하여 다음 메시지를 보내면 모델이 이전에 나눈 내용을 기억합니다.
- 어시스턴트 생성.
assistant_id는 재사용 가능한 프로필입니다. 메모리, 문서, 도구를 첨부해도 호출을 변경할 필요가 없습니다.
- 모델 선택. 제공업체 설정이 필요하지 않습니다. 기본값은
openai / gpt-4o로 설정되었습니다. 아래에 표시된 두 개의 인수를 사용하여 변경할 수 있습니다.
벡터 DB도, 상태 서버도, 제공업체 SDK도 없습니다. 단 하나의 호출만으로 충분합니다.
대화 계속하기
thread_id를 다시 전달하세요. 이제 모델이 문맥 (Context)을 갖게 됩니다.
follow_up = await client.send_message(
"Make it shorter.",
thread_id=response.thread_id,
...
이것이 추가 인프라 없이 구현되는 상태 유지 대화 (Stateful conversation)입니다.
두 개의 인자로 모델 교체하기
하나의 키로 수천 개의 모델을 사용할 수 있습니다. 메시지마다 제공업체 (Provider)와 모델을 변경하세요. 동일한 스레드 (Thread), 동일한 코드입니다.
response = await client.send_message(
"Explain quantum computing simply.",
llm_provider="anthropic",
...
다음 턴에 다른 모델을 사용하고 싶으신가요? 문자열 두 개만 바꾸면 됩니다. 특정 제공업체에 종속되지 않습니다.
메모리 활성화하기
memory="Auto"를 추가하면 어시스턴트가 단일 스레드 내뿐만 아니라 대화 전반에 걸쳐 사실을 기억합니다.
# Thread 1: 무언가를 알려주기
await client.send_message(
"My name is Sarah and I prefer dark mode.",
...
인자 하나로 구현되는 지속성 메모리 (Persistent memory). 프로비저닝할 데이터베이스도 필요 없습니다.
핵심 요약
플랫폼이 풀스택 (Full-stack)이기 때문에 첫 번째 호출이 단 한 줄로 끝납니다. 메모리, 모델 라우팅 (Model routing), RAG, 그리고 상태 유지 스레드 (Stateful threads)가 단 하나의 키 뒤에 자리 잡고 있습니다. 서비스가 아닌 인자를 추가함으로써, 작동하는 AI 메시지로 시작하여 필요에 따라 기능을 활성화할 수 있습니다.
가입하고, 키를 발급받아 첫 메시지를 보내보세요: app.backboard.io
전체 문서: docs.backboard.io