Skip to main content
도구를 사용하면 언어 모델이 외부 시스템과 상호작용하고 텍스트 생성을 넘어선 작업을 수행할 수 있습니다. LangSmith 플레이그라운드에서는 두 가지 유형의 도구를 사용할 수 있습니다:
  1. 내장 도구: 모델 제공업체(OpenAI, Anthropic 등)가 제공하는 사전 구성된 도구로, 즉시 사용할 수 있습니다. 웹 검색, 코드 해석 등의 기능이 포함됩니다.
  2. 커스텀 도구: 특정 작업을 수행하기 위해 사용자가 정의하는 함수입니다. 자체 시스템과 통합하거나 특화된 기능을 만들어야 할 때 유용합니다. LangSmith 플레이그라운드에서 커스텀 도구를 정의하면 모델이 올바른 인수를 사용하여 해당 도구를 정확하게 식별하고 호출하는지 확인할 수 있습니다. 곧 이러한 커스텀 도구 호출을 직접 실행할 수 있도록 지원할 예정입니다.

도구를 사용하는 시점

  • 내장 도구는 웹 검색이나 코드 해석과 같은 일반적인 기능이 필요할 때 사용하세요. 이러한 도구는 모델 제공업체가 구축하고 유지 관리합니다.
  • 커스텀 도구는 자체 도구 설계를 테스트하고 검증하고자 할 때 사용하세요. 다음과 같은 경우에 활용할 수 있습니다:
    • 모델이 어떤 도구를 사용하도록 선택하는지 검증하고, 도구 호출 시 제공하는 구체적인 인수를 확인할 때
    • 도구 상호작용을 시뮬레이션할 때

내장 도구

LangSmith 플레이그라운드는 OpenAI와 Anthropic의 다양한 도구를 기본적으로 지원합니다. 플레이그라운드에 명시적으로 나열되지 않은 도구를 사용하려면 type과 필요한 인수를 수동으로 지정하여 추가할 수 있습니다.

OpenAI 도구

Anthropic 도구

도구 추가 및 사용하기

도구 추가하기

프롬프트에 도구를 추가하려면 프롬프트 편집기 하단의 + Tool 버튼을 클릭하세요.

내장 도구 사용하기

  1. 도구 섹션에서 사용하려는 내장 도구를 선택합니다. 선택한 제공업체 및 모델과 호환되는 도구만 표시됩니다.
  2. 모델이 도구를 호출하면 플레이그라운드에 응답이 표시됩니다.

커스텀 도구 만들기

커스텀 도구를 만들려면 다음을 제공해야 합니다:
  • 이름: 도구에 대한 설명적인 이름
  • 설명: 도구가 수행하는 작업에 대한 명확한 설명
  • 인수: 도구에 필요한 입력값
참고: 플레이그라운드에서 커스텀 도구를 실행할 때 모델은 도구 이름과 도구 호출이 포함된 JSON 객체로 응답합니다. 현재로서는 MCP를 통해 호스팅된 도구에 연결할 수 있는 방법이 없습니다.

도구 선택 설정

일부 모델은 호출할 도구에 대한 제어 기능을 제공합니다. 이를 구성하려면:
  1. 프롬프트 설정으로 이동합니다.
  2. 도구 설정으로 이동합니다.
  3. 도구 선택을 선택합니다.
사용 가능한 도구 선택 옵션을 이해하려면 특정 제공업체의 문서를 확인하세요. 예를 들어, 도구 선택에 대한 OpenAI 문서를 참조하세요.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
I