Skip to main content
프롬프트를 만들고 평가하고 개선하는 일은 AI 엔지니어의 핵심 업무입니다. 프롬프트를 조금만 바꿔도 애플리케이션의 동작이 크게 달라질 수 있습니다. W&B Weave를 사용하면 프롬프트를 만들어 게시하고, 이를 지속적으로 개선해 나갈 수 있습니다. 이 페이지는 Weave에서 재사용 가능한 프롬프트 객체를 만들고, 애플리케이션 코드에서 참조할 수 있도록 게시하려는 AI 엔지니어를 대상으로 합니다. 이 가이드에서는 단일 문자열 프롬프트와 멀티턴 프롬프트를 만들고, 런타임 값으로 매개변수화하고, Weave 프로젝트에 게시하는 방법을 알아봅니다. 게시된 프롬프트를 참조 및 조회하고 버전을 관리하는 방법은 프롬프트 버전 저장 및 추적을 참조하세요.
프롬프트 객체를 레지스트리의 컬렉션에 연결하는 방법은 프롬프트를 컬렉션에 연결하기를 참조하세요.
프롬프트 요구 사항이 단순하다면 기본 제공되는 weave.StringPrompt 또는 weave.MessagesPrompt 클래스를 사용하면 됩니다. 요구 사항이 더 복잡하다면 이 클래스들이나 기본 클래스인 weave.Prompt를 상속하고 format 메서드를 재정의할 수 있습니다. weave.publish로 프롬프트를 게시하면 Weave 프로젝트의 Prompts 페이지에 표시되며, 사용자와 협업자는 이 페이지에서 프롬프트를 둘러보고 재사용할 수 있습니다.

StringPrompt

StringPrompt는 시스템 메시지, 사용자 쿼리 또는 LLM에 전달하는 독립적인 텍스트 입력에 사용할 수 있는 단일 문자열 프롬프트를 로깅합니다. 여러 메시지로 구성된 대화처럼 복잡한 구조가 필요하지 않은 개별 프롬프트 문자열을 관리하려면 StringPrompt를 사용하세요.

MessagesPrompt

MessagesPrompt를 사용하면 멀티턴 대화와 채팅 기반 프롬프트를 로깅할 수 있습니다. MessagesPrompt는 전체 대화 흐름을 나타내는 메시지 객체 배열(system, user, assistant 등의 역할 포함)을 저장합니다. 여러 메시지에 걸쳐 컨텍스트를 유지하거나, 특정 대화 패턴을 정의하거나, 재사용 가능한 대화 템플릿을 만들어야 하는 채팅 기반 LLM에는 MessagesPrompt를 사용하세요.

프롬프트 매개변수화

정적 프롬프트를 만들 수 있게 되었다면, 다음 단계는 프롬프트를 다양한 입력에 재사용할 수 있도록 만드는 것입니다. StringPrompt와 MessagesPrompt는 모두 매개변수화를 통해 동적 콘텐츠를 지원합니다. 매개변수화를 사용하면 런타임에 다른 값으로 채울 수 있는 플레이스홀더({variable} 구문 사용)가 포함된 재사용 가능한 프롬프트 템플릿을 만들 수 있습니다. 매개변수화는 일관된 구조를 유지하면서 다양한 입력, 사용자 데이터 또는 컨텍스트에 맞게 프롬프트를 조정해야 할 때 유용합니다. format() 메서드는 키-값 쌍을 받아 이러한 플레이스홀더를 실제 값으로 대체합니다.
멀티턴 대화 안에 플레이스홀더가 필요한 경우에도 MessagesPrompt에서 동일한 매개변수화 패턴을 사용할 수 있습니다.
마지막 수정일 2026년 9월 30일