AI 도구로 활용하기
비즈고 개발자 문서를 AI 도구에 연결하면 코드 생성·디버깅·API 연동 작업을 훨씬 빠르게 처리할 수 있습니다.
llms.txt — AI 전용 문서 인덱스
llms.txt는 AI 모델이 문서 구조를 효율적으로 파악할 수 있도록 제공하는 표준 포맷입니다.
각 페이지의 제목·URL·설명이 정리되어 있어 Cursor, Claude, ChatGPT 등에 컨텍스트로 추가하기 좋습니다.
| 파일 | 용도 | URL |
|---|---|---|
llms.txt | 문서 목록 인덱스 (가볍고 빠름) | https://developers.bizgo.io/llms.txt |
llms-full.txt | 전체 문서 내용 (완전한 컨텍스트) | https://developers.bizgo.io/llms-full.txt |
Cursor에서 사용하기
Cursor의 Docs 기능으로 비즈고 문서를 프로젝트에 등록하면 코드 작성 중 자동으로 참조합니다.
방법 1 — @Docs로 즉시 참조
@Docs https://developers.bizgo.io/llms.txt
비즈고 SMS 발송 API로 주문 완료 알림을 보내는 코드를 작성해줘
방법 2 — Docs 인덱스에 등록 (영구 참조)
- Cursor 설정 → Features → Docs 열기
+ Add new doc클릭- URL 입력:
https://developers.bizgo.io/llms.txt - 이후
@Bizgo Docs로 언제든 참조 가능
Claude에서 사용하기
Claude.ai
대화창에 아래 내용을 붙여넣으면 Claude가 비즈고 API 컨텍스트를 갖고 응답합니다.
아래 문서를 참고해서 답변해줘:
https://developers.bizgo.io/llms.txt
[질문 작성]
전체 문서가 필요한 경우:
https://developers.bizgo.io/llms-full.txt 를 읽고
비즈고 알림톡 발송 코드를 Node.js로 작성해줘
Claude Code (CLI)
.claude/CLAUDE.md 파일에 추가하면 프로젝트 전체에서 자동 참조됩니다.
## 외부 문서 참조
비즈고 API 관련 작업 시 아래 문서를 참고합니다:
- 문서 인덱스: https://developers.bizgo.io/llms.txt
- 전체 문서: https://developers.bizgo.io/llms-full.txt
ChatGPT에서 사용하기
GPT-4o / ChatGPT 프롬프트에 직접 붙여넣기
다음 URL의 내용을 참고해서 비즈고 API 연동 코드를 작성해줘:
https://developers.bizgo.io/llms.txt
또는 llms-full.txt 내용을 복사해서 프롬프트에 직접 붙여넣으면 가장 정확한 결과를 얻을 수 있습니다.
Function Calling으로 자동 발송
AI 에이전트에서 비즈고 API를 직접 호출하게 만들려면 Tool 정의를 추가합니다.
아래는 OpenAI / Anthropic SDK 기준 예시입니다.
{
"name": "send_bizgo_sms",
"description": "비즈고 API로 SMS 메시지를 발송합니다. 주문 완료·배송 안내·인증번호 등 정보성 메시지에 사용합니다.",
"parameters": {
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "수신번호 (예: 01012345678)"
},
"content": {
"type": "string",
"description": "메시지 본문 (90byte 초과 시 LMS 자동 전환)"
}
},
"required": ["to", "content"]
}
}
Tool이 호출되면 서버에서 아래처럼 비즈고 API를 실행합니다.
async function sendBizgoSms({ to, content }: { to: string; content: string }) {
const res = await fetch("https://api.bizgo.io/v2/comm/sms/send", {
method: "POST",
headers: {
"x-api-key": process.env.BIZGO_API_KEY!,
"Content-Type": "application/json",
},
body: JSON.stringify({
senderKey: process.env.BIZGO_SENDER_KEY,
messages: [{ to, content }],
}),
});
return res.json();
}
API 키는 반드시 서버 환경변수로 관리하세요. 클라이언트 코드나 AI 프롬프트에 직접 포함하면 안 됩니다.
함께 보는 문서
- 환경 설정하기 — API 키 발급 및 IP ACL 설정
- API 레퍼런스 — 전체 API 스펙 확인
- 발송 요청 구조 이해 — Fallback·Omni 구조 파악