한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
모델·API · 판정 관망
그림을 글로 풀면
기록 삽입도 형식을 확인
DeepSeek는 API 형식에 따라 대화 중 도구 기록 삽입 지원이 다릅니다.
- 대상
- 다른 API 형식으로 에이전트 대화 이력을 옮기는 개발자
- 무엇이 바뀜
- 앱이 추가하는 호출·결과와 모델이 요청한 도구 회신을 구분합니다.
- 왜 중요한가
- 같은 대화 이력을 모든 형식에 그대로 보낼 수 있다고 가정하면 안 됩니다.
- 지금 할 일
- 삽입 주체와 시점을 확인하고 사용할 API의 지원 규칙을 대조하세요.
- 한계·미확인
- 개념 비유. API 실행·호환성 시험·사람 검수 없음.
- 확인일
- 2026-10-28
먼저 누가 만든 도구 기록인지 구분하기
가상의 문서 조사 앱이 별도로 실행한 조회 결과를 이미 진행 중인 대화에 추가하려고 합니다. 이때 모델이 먼저 요청한 도구 호출에 답하는지, 앱이 새 호출 기록과 결과를 함께 끼워 넣는지부터 구분하세요. 그림의 묶인 두 장은 두 번째 경우입니다. 결과 내용이 같아도 대화 이력에 들어온 경로는 다를 수 있습니다.
DeepSeek의 형식별 중간 삽입 지원
공식 Tool Calls 문서는 모델이 생성하지 않은 도구 호출과 결과를 대화 중간에 넣는 기능을 API 형식별로 구분합니다. Anthropic API의 /messages와 Responses API는 이를 지원하지만 Chat Completion API는 지원하지 않는다고 안내합니다. 문서에 따르면 system 메시지의 중간 삽입은 이와 별개이며 Chat Completion에서도 지원됩니다. 도구 결과와 system 메시지를 같은 종류의 추가 기록으로 취급하지 마세요.
일반 회신까지 막힌 것으로 해석하지 않기
Chat Completion으로 모델이 요청한 도구의 결과를 돌려주는 일반 흐름과, 앱이 임의로 만든 도구 호출·결과를 중간에 추가하는 흐름은 다릅니다. AINOW는 전환 점검표에 API 형식, 호출 기록의 생성 주체, 결과 연결, 삽입 위치를 따로 적고 비민감한 시험 이력으로 확인할 것을 제안합니다. 도구 기록을 넣을 수 있다는 사실이 실제 도구 실행이나 업무 권한까지 보장하지는 않습니다. 이번 글에서는 실제 API 요청이나 호환성 시험을 수행하지 않았습니다.
참고 원문: DeepSeek 공식 Tool Calls 문서 — 대화 중 도구 호출 삽입 · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-28
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- 2026-10-28 공식 상시 문서 확인. Anthropic·Responses·Chat Completion 형식의 중간 삽입 지원 구분. API 호출 시험 없음
- 확인일
- 2026-10-28
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. API 실행·호환성 시험·사람 검수 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.