신규 무료로 가입하고 10회 호출해 보세요. 최대 $1, 카드 등록 불필요.

프롬프트

프롬프트를 버전으로 관리하고, 버전 간 변경 사항을 확인하고, 프로덕션 호출에 어떤 버전을 쓸지 정합니다.

콘솔 사이드바 위치(해당 기능이 계정에 적용되면 표시됩니다): Prompts 열기 ↗

진행 단계

  1. 프롬프트를 열고 새 프롬프트를 선택합니다. ID는 코드가 prompt_id로 보내는 값으로, 소문자, 숫자, 점, 하이픈, 밑줄을 쓸 수 있습니다.
  2. 편집기가 열립니다. 시스템 프롬프트와 메시지를 쓰고, 호출마다 바뀌는 부분은 {{name}}으로 적은 뒤 모델과 파라미터를 고릅니다. 호출하는 쪽에서 생략해도 되는 변수에는 기본값을 넣고 버전 저장을 선택합니다. 이후에는 버전에서 편집을 선택해 그 버전을 바탕으로 다음 버전을 작성합니다. 배포 전에 플레이그라운드에서 테스트를 선택하면 그 버전을 여러 모델로 나란히 실행해 볼 수 있습니다.
  3. 프롬프트 페이지로 돌아가 버전을 선택하면 이전 버전과의 차이, 필요한 변수, 그 버전을 호출하는 코드를 볼 수 있습니다.
  4. 버전을 배포하려면 production 레이블을 vN에 지정을 선택합니다. 대화 상자가 지금의 호출에 어떤 영향이 있는지 확인합니다. 기본값 없는 새 변수가 있으면 호출이 실패하므로, 기본값을 입력받아 다음 버전으로 저장합니다.
  5. 롤백하려면 production을 이전 버전으로 되돌리면 됩니다. 코드 수정도 재배포도 필요 없습니다.

제한과 유의 사항

  • 프롬프트 생성과 버전 저장은 모든 멤버가 할 수 있습니다. 레이블 이동·제거와 프롬프트 삭제는 관리자나 소유자만 할 수 있으며, 모두 워크스페이스 감사 로그에 기록됩니다.
  • 저장된 버전은 바뀌지 않습니다. 수정하면 항상 다음 버전이 되므로, 어제 레이블이 가리키던 버전은 언제든 되돌릴 수 있도록 남아 있습니다.
  • 레이블 이동과 삭제는 약 10초 안에 호출에 반영됩니다.
  • 프롬프트는 암호화되어 저장됩니다. 프롬프트를 삭제하면 버전과 레이블도 함께 삭제되고, 이후 그 ID로 호출하면 404가 반환됩니다. 이미 이루어진 호출은 로그에 남습니다.
  • 편집기의 요청 보기는 입력한 값으로 초안을 렌더링해, 각 엔드포인트에서 호출 시 전송될 내용을 보여 줍니다. 아무것도 저장되지 않고 모델도 호출되지 않습니다.

같은 기능의 API 레퍼런스: 프롬프트 라이브러리