Skip to content

README.md

Latest commit

 

History

History
189 lines (133 loc) · 11.9 KB

README.md

File metadata and controls

189 lines (133 loc) · 11.9 KB

Visual Studio Code의 AI Toolkit 확장을 사용하여 서버 활용하기

AI 에이전트를 구축할 때, 단순히 스마트한 응답을 생성하는 것만이 아니라 에이전트가 실제로 행동을 취할 수 있는 능력을 부여하는 것이 중요합니다. 바로 여기서 Model Context Protocol (MCP)이 등장합니다. MCP는 에이전트가 외부 도구와 서비스를 일관된 방식으로 쉽게 접근할 수 있도록 해줍니다. 마치 에이전트를 실제로 사용할 수 있는 도구 상자에 연결하는 것과 같습니다.

예를 들어, 에이전트를 계산기 MCP 서버에 연결했다고 가정해봅시다. 그러면 에이전트는 "47 곱하기 89는 얼마야?"와 같은 프롬프트를 받는 것만으로 수학 연산을 수행할 수 있게 됩니다. 로직을 하드코딩하거나 커스텀 API를 구축할 필요가 없습니다.

개요

이 레슨에서는 Visual Studio Code의 AI Toolkit 확장을 사용하여 계산기 MCP 서버를 에이전트에 연결하는 방법을 다룹니다. 이를 통해 에이전트가 덧셈, 뺄셈, 곱셈, 나눗셈과 같은 수학 연산을 자연어를 통해 수행할 수 있게 됩니다.

AI Toolkit은 Visual Studio Code에서 에이전트 개발을 간소화하는 강력한 확장 프로그램입니다. AI 엔지니어는 로컬 또는 클라우드에서 생성형 AI 모델을 개발하고 테스트하여 AI 애플리케이션을 쉽게 구축할 수 있습니다. 이 확장은 현재 사용 가능한 주요 생성형 모델 대부분을 지원합니다.

참고: AI Toolkit은 현재 Python과 TypeScript를 지원합니다.

학습 목표

이 레슨을 마치면 다음을 수행할 수 있습니다:

  • AI Toolkit을 통해 MCP 서버를 활용하기.
  • MCP 서버가 제공하는 도구를 발견하고 사용할 수 있도록 에이전트 설정을 구성하기.
  • 자연어를 통해 MCP 도구를 활용하기.

접근 방식

다음은 전체적인 접근 방식입니다:

  • 에이전트를 생성하고 시스템 프롬프트를 정의합니다.
  • 계산기 도구를 포함한 MCP 서버를 생성합니다.
  • Agent Builder를 MCP 서버에 연결합니다.
  • 자연어를 통해 에이전트의 도구 호출을 테스트합니다.

좋습니다. 이제 흐름을 이해했으니, MCP를 통해 외부 도구를 활용하여 AI 에이전트의 기능을 확장해봅시다!

사전 준비

실습: 서버 활용하기

Warning

macOS 사용자 참고: 현재 macOS에서 종속성 설치에 영향을 미치는 문제를 조사 중입니다. 이로 인해 macOS 사용자는 이 튜토리얼을 현재 완료할 수 없습니다. 문제가 해결되는 대로 지침을 업데이트하겠습니다. 기다려주셔서 감사합니다!

이 실습에서는 Visual Studio Code의 AI Toolkit을 사용하여 MCP 서버의 도구를 활용하여 AI 에이전트를 구축, 실행 및 개선합니다.

-0- 사전 단계: OpenAI GPT-4o 모델을 My Models에 추가하기

이 실습에서는 GPT-4o 모델을 사용합니다. 에이전트를 생성하기 전에 이 모델을 My Models에 추가해야 합니다.

  1. Activity Bar에서 AI Toolkit 확장을 엽니다.
  2. Catalog 섹션에서 Models를 선택하여 Model Catalog를 엽니다. Models를 선택하면 Model Catalog가 새 편집기 탭에서 열립니다.
  3. Model Catalog 검색창에 OpenAI GPT-4o를 입력합니다.
  4. + Add를 클릭하여 모델을 My Models 목록에 추가합니다. GitHub에서 호스팅된 모델을 선택했는지 확인하세요.
  5. Activity Bar에서 OpenAI GPT-4o 모델이 목록에 나타나는지 확인합니다.

-1- 에이전트 생성하기

Agent (Prompt) Builder를 사용하면 AI 기반 에이전트를 생성하고 사용자 정의할 수 있습니다. 이 섹션에서는 새 에이전트를 생성하고 대화를 구동할 모델을 지정합니다.

  1. Activity Bar에서 AI Toolkit 확장을 엽니다.
  2. Tools 섹션에서 Agent (Prompt) Builder를 선택합니다. Agent (Prompt) Builder를 선택하면 새 편집기 탭에서 Agent (Prompt) Builder가 열립니다.
  3. + New Agent 버튼을 클릭합니다. 확장은 Command Palette를 통해 설정 마법사를 실행합니다.
  4. 이름으로 Calculator Agent를 입력하고 Enter를 누릅니다.
  5. Agent (Prompt) Builder에서 Model 필드에 OpenAI GPT-4o (via GitHub) 모델을 선택합니다.

-2- 에이전트의 시스템 프롬프트 생성하기

에이전트의 기본 구조를 생성한 후, 이제 에이전트의 성격과 목적을 정의할 차례입니다. 이 섹션에서는 Generate system prompt 기능을 사용하여 계산기 에이전트의 의도된 동작을 설명하고 모델이 시스템 프롬프트를 작성하도록 합니다.

  1. Prompts 섹션에서 Generate system prompt 버튼을 클릭합니다. 이 버튼은 에이전트의 시스템 프롬프트를 생성하는 프롬프트 빌더를 엽니다.
  2. Generate a prompt 창에서 다음을 입력합니다: 당신은 유용하고 효율적인 수학 도우미입니다. 기본 산술 문제를 받으면 올바른 결과를 제공합니다.
  3. Generate 버튼을 클릭합니다. 오른쪽 하단에 시스템 프롬프트가 생성 중임을 알리는 알림이 나타납니다. 프롬프트 생성이 완료되면 Agent (Prompt) Builder의 System prompt 필드에 프롬프트가 나타납니다.
  4. System prompt를 검토하고 필요하면 수정합니다.

-3- MCP 서버 생성하기

에이전트의 시스템 프롬프트를 정의하여 동작과 응답을 안내한 후, 이제 에이전트에 실질적인 기능을 추가할 차례입니다. 이 섹션에서는 덧셈, 뺄셈, 곱셈, 나눗셈 계산을 실행할 도구를 포함한 계산기 MCP 서버를 생성합니다. 이 서버는 에이전트가 자연어 프롬프트에 따라 실시간으로 수학 연산을 수행할 수 있도록 합니다.

AI Toolkit은 사용자 정의 MCP 서버를 쉽게 생성할 수 있는 템플릿을 제공합니다. 우리는 계산기 MCP 서버를 생성하기 위해 Python 템플릿을 사용할 것입니다.

참고: AI Toolkit은 현재 Python과 TypeScript를 지원합니다.

  1. Agent (Prompt) Builder의 Tools 섹션에서 + MCP Server 버튼을 클릭합니다. 확장은 Command Palette를 통해 설정 마법사를 실행합니다.

  2. + Add Server를 선택합니다.

  3. Create a New MCP Server를 선택합니다.

  4. 템플릿으로 python-weather를 선택합니다.

  5. MCP 서버 템플릿을 저장할 폴더로 Default folder를 선택합니다.

  6. 서버 이름으로 Calculator를 입력합니다.

  7. 새 Visual Studio Code 창이 열립니다. Yes, I trust the authors를 선택합니다.

  8. Terminal 메뉴에서 New Terminal을 열어 가상 환경을 생성합니다: python -m venv .venv

  9. 터미널에서 가상 환경을 활성화합니다:

    • Windows - .venv\Scripts\activate
    • macOS/Linux - source .venv/bin/activate

  10. 터미널에서 종속성을 설치합니다: pip install -e .[dev]

  11. Activity Bar의 Explorer 보기에서 src 디렉토리를 확장하고 server.py를 선택하여 파일을 편집기에서 엽니다.

  12. server.py 파일의 코드를 다음으로 교체하고 저장합니다:

    """
Sample MCP Calculator Server implementation in Python.


This module demonstrates how to create a simple MCP server with calculator tools
that can perform basic arithmetic operations (add, subtract, multiply, divide).
"""

from mcp.server.fastmcp import FastMCP

server = FastMCP("calculator")

@server.tool()
def add(a: float, b: float) -> float:
    """Add two numbers together and return the result."""
    return a + b

@server.tool()
def subtract(a: float, b: float) -> float:
    """Subtract b from a and return the result."""
    return a - b

@server.tool()
def multiply(a: float, b: float) -> float:
    """Multiply two numbers together and return the result."""
    return a * b

@server.tool()
def divide(a: float, b: float) -> float:
    """
    Divide a by b and return the result.
    
    Raises:
        ValueError: If b is zero
    """
    if b == 0:
        raise ValueError("Cannot divide by zero")
    return a / b

-4- 계산기 MCP 서버와 함께 에이전트 실행하기

이제 에이전트가 도구를 갖췄으니 이를 사용해볼 차례입니다! 이 섹션에서는 에이전트에 프롬프트를 제출하여 계산기 MCP 서버의 적절한 도구를 활용하는지 테스트하고 검증합니다.

  1. MCP 서버를 디버깅하려면 F5를 누릅니다. Agent (Prompt) Builder가 새 편집기 탭에서 열립니다. 서버 상태는 터미널에서 확인할 수 있습니다.
  2. Agent (Prompt) Builder의 User prompt 필드에 다음 프롬프트를 입력합니다: 나는 각각 $25인 물건 3개를 샀고, $20 할인권을 사용했어. 총 얼마를 지불했지?
  3. Run 버튼을 클릭하여 에이전트의 응답을 생성합니다.
  4. 에이전트 출력을 검토합니다. 모델은 $55를 지불했다고 결론을 내려야 합니다.
  5. 다음과 같은 과정이 발생해야 합니다:
    • 에이전트가 계산을 돕기 위해 multiply와 subtract 도구를 선택합니다.
    • multiply 도구에 각각 a와 b 값이 할당됩니다.
    • subtract 도구에 각각 a와 b 값이 할당됩니다.
    • 각 도구의 응답이 Tool Response에 제공됩니다.
    • 모델의 최종 출력이 Model Response에 제공됩니다.
  6. 추가 프롬프트를 제출하여 에이전트를 더 테스트합니다. User prompt 필드에서 기존 프롬프트를 클릭하여 수정할 수 있습니다.
  7. 테스트가 끝나면 터미널에서 CTRL/CMD+C를 입력하여 서버를 종료할 수 있습니다.

과제

server.py 파일에 추가 도구 항목(예: 숫자의 제곱근 반환)을 추가해보세요. 에이전트가 새 도구(또는 기존 도구)를 활용해야 하는 추가 프롬프트를 제출하세요. 새로 추가된 도구를 로드하려면 서버를 재시작해야 합니다.

솔루션

Solution

주요 내용

이 장의 주요 내용은 다음과 같습니다:

  • AI Toolkit 확장은 MCP 서버와 그 도구를 활용할 수 있는 훌륭한 클라이언트입니다.
  • MCP 서버에 새 도구를 추가하여 에이전트의 기능을 확장하고 변화하는 요구 사항을 충족할 수 있습니다.
  • AI Toolkit은 사용자 정의 도구 생성을 간소화하는 템플릿(예: Python MCP 서버 템플릿)을 포함하고 있습니다.

추가 자료

다음 단계

면책 조항:
이 문서는 AI 번역 서비스 Co-op Translator를 사용하여 번역되었습니다. 정확성을 위해 최선을 다하고 있지만, 자동 번역에는 오류나 부정확성이 포함될 수 있습니다. 원본 문서의 원어를 신뢰할 수 있는 권위 있는 출처로 간주해야 합니다. 중요한 정보의 경우, 전문적인 인간 번역을 권장합니다. 이 번역 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.