DeepSeek V4 API 도구 호출 특성

DeepSeek V4 모델을 GitHub Copilot Chat과 통합하는 과정에서 발견된 API 동작 특성에 대한 분석 결과다. 기존 OpenAI 브릿지 방식이 도구 호출(Tool Call)이 활성화된 대화의 두 번째 턴부터 400 에러를 발생시키는 문제를 해결하기 위해 전용 프로바이더를 개발하며 확인된 내용이다.

주요 발견 사항: DeepSeek API 문서에 따르면, 도구 호출이 없는 일반 대화에서는 이전 턴의 reasoning_content를 전달하지 않아도 되지만, 도구 호출(Tool Call)이 발생한 턴이 포함된 경우에는 이후 모든 요청에서 해당 reasoning_content를 반드시 포함하여 전달해야 한다.

테스트 결과 요약:

• 도구 호출이 없는 경우: 이전 어시스턴트 메시지의 reasoning_content를 생략해도 정상 작동(200 OK).
• 도구 호출이 포함된 경우: 도구 호출 이후, 이전 일반 텍스트 어시스턴트 메시지의 reasoning_content를 누락하면 400 에러(reasoning_content must be passed back) 발생.
• 도구 호출이 없는 상태에서 도구 정의만 포함된 경우: 정상 작동(200 OK).

이러한 특성은 DeepSeek V4를 활용해 에이전트나 도구 호출 기능을 구현하는 개발자들이 API 연동 시 반드시 고려해야 할 핵심 사항이다.