---
title: 모범 사례
description: Format과 Agent Completions를 안정적으로 호출하기 위한 짧은 패턴과 복사해 쓸 수 있는 예제입니다.
---

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

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

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

<!-- api-call-example:format-vanity-run -->

전체 계약은 [Format 호출하기](/formats/call)를, 타입이 있는 JSON이 필요하면
[구조화 출력](/formats/structured-output)을 보세요.

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

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

전체 규칙: [구조화 출력](/formats/structured-output).

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

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

<!-- api-call-example:agent-completion -->

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

팀 handle에 프로비저닝된 Format에는 **팀** API 키를 쓰세요. 클라이언트에
필요한 최소 scope만 주고, [Dashboard](/dashboard/api-keys)에서 키를 교체하세요.

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

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