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 인덱스에 등록 (영구 참조)

  1. Cursor 설정 → Features → Docs 열기
  2. + Add new doc 클릭
  3. URL 입력: https://developers.bizgo.io/llms.txt
  4. 이후 @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 프롬프트에 직접 포함하면 안 됩니다.


함께 보는 문서