한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
모델·API · 판정 관망
그림을 글로 풀면
요약 수신과 본문 확보를 구분
DeepSeek 검색은 기본적으로 본문을 요청하지 않아 요약만 받을 수 있습니다.
- 대상
- 검색 자료를 읽는 AI 에이전트를 만드는 개발자
- 무엇이 바뀜
- 검색 결과 목록과 페이지 본문은 구분해 다룹니다.
- 왜 중요한가
- 요약을 원문 전체로 취급하면 실제 확인 범위를 과장하게 됩니다.
- 지금 할 일
- 요청 옵션과 content 값을 확인하고 필요한 페이지의 본문을 대조하세요.
- 한계·미확인
- 개념 비유. API 호출·검색 품질·본문 수집 시험 없음.
- 확인일
- 2026-10-20
검색 카드만 받았는데 책을 다 읽었다고 기록하지 않기
가상의 자료 조사 에이전트가 검색 결과의 제목과 요약을 받은 뒤 근거 확인을 완료했다고 기록하는 상황을 생각해 봅니다. 그림의 안내 카드는 자료를 찾는 데 도움이 되지만 펼친 책과 같은 정보량을 뜻하지 않습니다. AINOW는 수집 기록에 요약만 확인했는지, 본문도 확보했는지를 구분하고 답변에 필요한 조건이 실제 입력에 들어왔는지 대조하도록 제안합니다.
본문 필드는 요청 옵션과 결과를 함께 확인합니다
DeepSeek 공식 가이드에서 Search의 need_content는 기본값이 false입니다. 이 상태에서는 content가 빈 문자열이며, true로 요청했더라도 내용을 얻지 못하면 비어 있을 수 있습니다. summary와 content는 별도 필드이므로 요약이 있다는 이유만으로 본문 수신을 확정하지 마세요. 옵션을 바꾼 사실과 실제 응답에 본문이 담긴 사실은 서로 다른 확인 단계입니다.
필요한 주소를 읽고 확보하지 못한 범위는 남기기
Fetch는 지정한 한 웹페이지의 내용을 Markdown으로 가져오는 별도 API입니다. 다만 대상 사이트의 가용성과 접근 정책에 영향을 받습니다. AINOW는 필요한 주소의 본문 확보 여부를 확인하고 실패하면 미확인으로 남기도록 제안합니다. 검색에서 이미 필요한 본문을 확보했다면 무조건 추가 호출할 이유는 없습니다. 이번 글은 문서 대조이며 API를 호출하거나 접근 제한을 우회하거나 검색 품질을 측정하지 않았습니다.
참고 원문: DeepSeek 공식 가이드 — Search와 Fetch의 응답 내용 · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-20
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- Search & Fetch 가이드, 2026-10-20 열람. need_content 기본값 false·summary/content 구분·Fetch 접근 조건. API 호출 및 수집 성공률 시험 없음
- 확인일
- 2026-10-20
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. API 호출·검색 품질·본문 수집 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.