모범 사례

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

파트너 연동을 단순하고 안정적으로 유지하는 몇 가지 패턴입니다. 아래 인터랙티브 예제를 출발점으로 쓰고, handle·slug·instruction만 계정에 맞게 바꾸세요.

원시 모델 호출보다 Format을 우선하세요

저장해 둔 레시피가 있으면 handle과 slug로 호출하세요. Format이 도구, 지출 게이트, 하우스 스타일을 담당하고, 클라이언트는 브리프만 보냅니다.

전체 계약은 Format 호출하기를, 타입이 있는 JSON이 필요하면 구조화 출력을 보세요.

시스템이 결과를 소비할 때는 스키마를 묶으세요

다른 서비스가 receipt를 읽을 거면 output_schema를 묶어 자유 텍스트 대신 검증된 객체를 받으세요. Format이 실제로 만드는 필드만 required로 두세요.

전체 규칙: 구조화 출력.

일회성 작업에는 Agent Completions를 쓰세요

아직 저장한 Format이 없거나 브리프가 매번 바뀌면, 지출 상한을 두고 Agent Completion을 보내세요.

자격 증명은 범위를 좁게 유지하세요

팀 handle에 프로비저닝된 Format에는 팀 API 키를 쓰세요. 클라이언트에 필요한 최소 scope만 주고, Dashboard에서 키를 교체하세요.

모든 실행에 지출 상한을 두세요

항상 generation_spend_cap_usd를 설정하세요(해당하면 agent cap도). 상한이 빠진 호출은 편의가 아니라 클라이언트 버그로 취급하세요.