본 문서는deepseek-harness-sdk==0.1.0rc6및deepseek-harness-runtime-bin==0.1.0rc6에 적합합니다. 클라이언트를 업그레이드한 후, 아래의 읽기 전용 파일 테스트를 다시 완료하십시오.
지원 범위
모델 디렉토리는 변경될 수 있습니다. 실행 전에 Coding Plan 전용 키를 사용하여 실시간 디렉토리를 조회하십시오:
deepseek-v4-pro가 포함되어 있는지 확인하십시오. deepseek-v4-flash를 본 문서의 도구 모드의 동등한 대체로 사용하지 마십시오; 이번 고정 버전 검증에서, 그것의 다중 추론 이력과 도구 재생이 통과하지 않았습니다.
1. 전용 키 준비
Coding Plan 애플리케이션을 열고, 구매한 Coding Application에 들어가 전용 API Key를 생성하거나 복사하십시오. Coding Plan은 일반 잔액을 사용하지 않으며, 다른 애플리케이션의 키는 패키지 권한을 대표할 수 없습니다. 키를 현재 셸에만 넣으십시오:2. 격리된 작업 공간 생성
Harness의 번들된 런타임은 로컬 Bash 도구를 포함합니다. 첫 번째 검증에서는 실제 프로젝트나 홈 디렉토리를 가리키지 마십시오; 비밀이 없는 일회성 디렉토리를 생성하십시오:deepseek-harness-runtime-bin이 동시에 존재하는지 먼저 확인하십시오. danger-full-access를 사용하여 파일 접근 범위를 확대하지 마십시오; 본 문서의 예시는 일회성 디렉토리만 cwd에 전달합니다.
3. 공식 Python SDK 실행
아래 내용을/tmp/deepseek-harness-demo/run.py로 저장하십시오:
/v1/chat/completions, SSE, 추론 내용, 도구 호출 및 도구 결과 회신을 동시에 검증합니다. 완료 후 /tmp/deepseek-harness-demo를 삭제할 수 있으며; 세션 디렉토리에 프로젝트 컨텍스트가 포함되어 있다면, 코드 저장소와 동일한 민감도 수준으로 보관해야 합니다.
자주 묻는 질문
- 401:
ACEDATACLOUD_API_KEY가 Python을 실행하는 동일한 셸에 내보내졌는지 확인하십시오. - 403 또는 한도 알림: 키가 현재 Coding Application에 속하며, 패키지가 여전히 유효하고 잔여 한도가 있는지 확인하십시오.
- 모델 사용 불가:
/v1/models를 다시 조회하고, 이전 스크린샷을 기반으로 모델 이름을 추측하지 마십시오. reasoning_content/ 도구 재생 오류: SDK/runtime가 본 문서의 고정 버전이며,deepseek-v4-pro를 사용하고 있는지 확인하십시오.- 도구 실행 횟수 이상: 부작용을 일으킬 수 있는 작업을 중지하고, 본 문서의 읽기 전용 fixture로 현재 서비스 버전을 검증하십시오.
- 설치 실패: Python 3.10+, 운영 체제 아키텍처가 현재 wheel을 지원하는지 확인하고, SDK/runtime 버전이 일치하는지 확인하십시오.
능력 경계
본 문서는 로컬 Python SDK에서 Chat Completions의 텍스트 및 도구 루프만 검증합니다. 이미지, Files API,/v1/responses, /v1/messages, 원격 작업 공간 및 호스팅 샌드박스는 본 튜토리얼의 약속 범위에 포함되지 않으며; 작업 공간 권한 및 로컬 명령 위험은 Harness를 실행하는 머신과 구성에 의해 책임집니다.

