spell

주문(spell) 잘 적기

주문은 마도서 안의 개별 동작. 사용자에게는 안 보이고 AI와 메이커만 봐요. 잘 적은 주문은 AI가 언제 부를지 정확하게 판단합니다.

호출 마법언어와 다릅니다

사용자가 외쳐서 부르는 건 호출 마법언어예요. 그건 마도서 자체를 부르는 이름이고, 여기서 다루는 주문(spell) 이름은 AI 내부 식별자입니다. 사용자는 못 봐요.

권장 형태

namesnake_case 영문. AI가 부를 때 쓰는 함수 이름.
description가장 중요. AI가 이 주문을 언제 부를지 판단하는 자연어 설명. 사용자 발화 예시까지 적으면 더 좋아요.
inputSchema.type항상 object.
inputSchema.properties받을 인자들. 각 인자에 type(string/integer/number/boolean/array/object)과 가능하면 description까지.
inputSchema.required(선택) 필수 인자 이름 배열. 빠지면 모두 선택 인자.

잘 적은 예시

- name: get_rate
  description: 두 통화 간 현재 환율을 돌려줌. 사용자가 "환율이 얼마야"라고 묻거나 환전을 고민할 때 부른다.
  inputSchema:
    type: object
    properties:
      from:
        type: string
        description: ISO 4217 통화 코드. 예 USD, KRW, JPY
      to:
        type: string
        description: 변환 대상 통화 (ISO 4217)
    required:
      - from
      - to

description에 호출 트리거(어떤 사용자 발화일 때 부를지)까지 적은 점, 각 인자에 단위·형식까지 적은 점이 핵심.

덜 잘 적은 예시

- name: doStuff
  description: stuff
  inputSchema:
    type: object
    properties:
      x:
        type: string

이름·설명·인자가 모호해서 AI가 호출 시점을 추론하기 어렵습니다.

← Manifest 전체 스펙 호출 마법언어 →