[실습] Tool Calling 개발 환경 구축

JSCODE 시니

2026. 06. 13.

✅ 1. 프로젝트 생성

• Name : tool

• Language : Java

• Type : Gradle-Groovy

• Group : com.jscode

• Artifact : tool

• Java : 21

• Packaging : Jar

✅ 2. 의존성 추가

dependencies {
  implementation 'org.springframework.boot:spring-boot-starter-webmvc'
  implementation 'org.springframework.ai:spring-ai-starter-model-ollama'
  implementation 'org.springframework.ai:spring-ai-starter-model-openai'
  // 스웨거 의존성 추가
  implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:3.0.1") 
  testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test'
  testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

• 스웨거 의존성은 수동으로 추가할 것

✅ 3. application.yaml 파일 생성

# 애플리케이션 커스텀 옵션 추가
app:
  cli:
    enabled: true  # CLI 모드 활성화 여부
  chat:
    default-system-prompt: 한국어를 사용하는 tool 지원 AI 입니다.  # 기본 system prompt

logging:
  level:
    org:
      springframework:
        ai:
          chat:
            client:
              advisor: DEBUG  # SimpleLoggerAdvisor 등의 Advisor에서 DEBUG 로그 출력
          tool: DEBUG  # Tool 사용 관련 DEBUG 로그 출력

spring:
  application:
    name: tool  # 애플리케이션 이름
  ai:
    model:
      chat: openai  # 여러 Chat 모델 사용 시 auto-configurations 에서 사용할 모델 설정 필요 예: openai, ollama
    openai:
      api-key: ${OPENAI_API_KEY}  # OpenAI 호출 API를 제공하는 Provider의 경우 아래 내용을 적절히 수정
      chat:
        model: openai/gpt-4.1-nano
        base-url: https://models.github.ai/inference  # 설정하지 않으면 기본 OpenAI api 호출 주소를 사용
        completions-path: /chat/completions  # OpenAI 기본값은 /v1/chat/completions, github 모델 사용 시 아래와 같이 수정

✅ 4. 환경설정

• 해당 프로젝트에서는 OPENAI API를 사용함

• 이전과 동일한 방법으로 환경설정 세팅

• Name과 Value의 값에 오탈자 들어가지 않도록 주의!