Prompt는 대규모 언어 모델(LLM)의 동작을 안내합니다. Prompt engineering은 LLM이 신뢰할 수 있고 유용한 응답을 생성하도록 지시사항을 작성하고, 테스트하고, 개선하는 과정입니다. LangSmith는 prompt를 생성하고, 버전 관리하고, 테스트하고, 협업할 수 있는 도구를 제공합니다. 또한 구조화된 prompt를 재사용할 수 있는 prompt template과 prompt에 값(예: 사용자의 질문)을 동적으로 삽입할 수 있는 변수와 같은 일반적인 개념을 접하게 됩니다. 이 빠른 시작에서는 UI 또는 SDK를 사용하여 prompt를 생성하고, 테스트하고, 개선합니다. 이 빠른 시작은 OpenAI를 예시 LLM provider로 사용하지만, 동일한 워크플로우가 다른 provider에도 적용됩니다.
Prompt engineering 시작하기에 대한 비디오를 선호하는 경우 빠른 시작 비디오 가이드를 참조하세요.

사전 요구 사항

시작하기 전에 다음을 준비해야 합니다: UI 또는 SDK 워크플로우에 대한 탭을 선택하세요:
  • UI
  • SDK

1. workspace secret 설정

LangSmith UI에서 OpenAI API key가 workspace secret으로 설정되어 있는지 확인하세요.
  1. Settings로 이동한 다음 Secrets 탭으로 이동합니다.
  2. Add secret을 선택하고 OPENAI_API_KEY를 입력한 후 API key를 Value로 입력합니다.
  3. Save secret을 선택합니다.
LangSmith UI에서 workspace secret을 추가할 때, secret key가 모델 제공자가 예상하는 environment variable 이름과 일치하는지 확인하세요.

2. prompt 생성

  1. LangSmith UI에서 왼쪽 메뉴의 Prompts 섹션으로 이동합니다.
  2. + Prompt를 클릭하여 prompt를 생성합니다.
  3. 필요에 따라 prompt와 입력 변수를 편집하거나 추가하여 prompt를 수정합니다.
편집 준비가 된 system prompt가 있는 Prompt playground.

3. prompt 테스트

  1. Prompts 제목 아래에서 모델 이름 옆의 톱니바퀴 아이콘을 선택하면 Model Configuration 탭의 Prompt Settings 창이 열립니다.
  2. 사용하려는 model configuration을 설정합니다. 선택한 ProviderModel에 따라 이 구성 페이지에서 구성 가능한 매개변수가 결정됩니다. 설정이 완료되면 Save as를 클릭합니다.
    LangSmith UI의 Model Configuration 창, Provider, Model, Temperature, Max Output Tokens, Top P, Presence Penalty, Frequency Penalty, Reasoning Effort 등의 설정.
  3. Inputs 박스에서 테스트하려는 입력 변수를 지정한 다음 Start를 클릭합니다.
    질문이 입력된 input 박스. output 박스에는 prompt에 대한 응답이 포함되어 있습니다.
    Playground에서 prompt를 구성하는 더 많은 옵션에 대해 알아보려면 prompt 설정 구성을 참조하세요.
  4. prompt를 테스트하고 개선한 후 Save를 클릭하여 향후 사용을 위해 저장합니다.

4. prompt 반복 개선

LangSmith는 팀 기반 prompt 반복 개선을 지원합니다. Workspace 멤버는 playground에서 prompt를 실험하고 준비가 되면 변경 사항을 새로운 commit으로 저장할 수 있습니다.prompt를 개선하려면:
  • 모델 provider가 제공하는 문서에서 prompt 생성 모범 사례를 참조하세요:
  • LangSmith의 대화형 도구인 Prompt Canvas로 prompt를 구축하고 개선하세요. 자세한 내용은 Prompt Canvas 가이드를 참조하세요.
  • 특정 commit에 태그를 지정하여 commit 기록에서 중요한 순간을 표시합니다.
    1. commit을 생성하려면 Playground로 이동하여 Commit을 선택합니다. 변경 사항을 commit할 prompt를 선택한 다음 Commit을 클릭합니다.
    2. 왼쪽 메뉴에서 Prompts로 이동합니다. prompt를 선택합니다. prompt의 상세 페이지에서 Commits 탭으로 이동합니다. 태그 아이콘 을 찾아 Add a Commit Tag를 클릭합니다.
    태그, commit 레이블이 있는 commit tag 박스, 태그를 생성하기 위한 commit tag name 박스.

다음 단계

비디오 가이드


Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
I