DeepSeek 하네스와 DeepSeek 코드 하네스란 무엇입니까?

여기서 용어는 DeepSeek 지향 코딩 모델을 중심으로 컨텍스트, 도구 및 작업 루프를 조정하는 에이전트 하네스를 나타냅니다.

DeepSeek Harness는 맞춤형 공급자를 사용할 수 있습니까?

문서화된 OpenAI 호환 사용자 정의 공급자 필드를 사용하고 TokenHub 기본 URL을 입력하고 환경 변수에서 API 키를 읽습니다.

DeepSeek Harness에는 어떤 모델을 사용해야 합니까?

안정적인 기본 도구 호출, 충분한 컨텍스트, 구성된 프로토콜에 대한 검증된 지원을 갖춘 코딩 모델을 선택하세요.

DeepSeek Harness가 내 프로젝트에 가장 적합한 옵션입니까?

보편적인 최선의 주장을 하기에는 이용 가능한 검색 증거가 너무 제한적입니다. 자체 리포지토리에서 설정, 도구 성공, 대기 시간, 컨텍스트 및 비용을 비교하세요.

DeepSeek Harness가 실패하면 무엇을 확인해야 합니까?

기본 URL, 환경 변수, API 키, 모델 ID 및 기본 도구 지원을 확인한 다음 TokenHub 로그를 사용하여 요청이 도착했는지 식별합니다.

DeepSeek 하네스(DeepSeek 코드 하네스) 사용자 정의 공급자 설정 가이드

DeepSeek Harness(dsh)는 모델 페이지에서 TokenHub를 사용자 정의 공급자로 추가할 수 있습니다. 각 공급자는 게이트웨이가 실제로 노출하는 하나의 프로토콜을 선언해야 합니다. TokenHub OpenAI Chat Completions의 경우 https://us-api.tokenhub.com/v1와 함께 openai-completions를 사용하세요.

DeepSeek Harness는 개발자 미리보기에 남아 있으며, 관리자는 릴리스에 주요 변경 사항이 포함될 수 있다고 경고합니다. 실제 저장소를 사용하기 전에 위험도가 낮은 작업과의 연결을 검증하십시오.

이 통합이 적합한 경우

DeepSeek Harness는 모델, 도구 및 작업공간을 에이전트에 결합하는 개발 워크플로를 위해 고안되었습니다. 공급자, 모델 및 세션 설정을 유지합니다. 나중에 기본 모델 및 세션 참조를 마이그레이션할 필요가 없도록 생성하기 전에 안정적인 공급자 ID를 선택하십시오.

DeepSeek Harness 시작

공식 명령을 사용하여 로컬 웹 UI를 시작합니다.

npx @deepseek-ai/dsh web

그러면 로컬 UI가 시작되고 브라우저에서 열려고 시도됩니다. SSH를 통해 실행하거나 원격 환경에서 실행하는 경우 액세스 주소는 프로젝트의 웹 UI 지침을 따르세요. 공급자를 구성하기 전에 UI에 접근할 수 있는지 확인하세요.

TokenHub 자격 증명 및 모델 준비

TokenHub 대시보드에서 API 키를 생성하고 모델 카탈로그에서 정확한 모델 ID를 복사하세요. 키를 저장소에 커밋하거나 공유하지 마세요.

필드	가치
제공자 ID	`tokenhub`와 같은 안정적인 소문자 ID를 사용하세요.
베이스 URL	`https://us-api.tokenhub.com/v1`
API 프로토콜	`openai-completions`
자격 증명	TokenHub API 키
모델 ID	TokenHub 모델 카탈로그의 정확한 ID

TokenHub 사용자 정의 공급자 추가

Settings → Models를 엽니다.
Add a custom provider를 선택합니다. TokenHub를 기본 제공 공급자 중 하나로 구성하지 마십시오.
소문자 공급자 ID, 표시 이름, 기본 URL, API 프로토콜 및 API 키를 입력합니다.
모델 목록에 하나 이상의 정확한 TokenHub 모델 ID를 추가하고 저장하세요.
모델 선택기로 돌아가서 저장한 공급자와 모델을 선택하고 새 세션을 만들어 이를 확인하세요.

하나의 공급자는 하나의 프로토콜만 사용할 수 있습니다. 게이트웨이가 OpenAI Chat Completions, 응답 및 Anthropic Messages를 노출하는 경우 프로토콜을 혼합하는 대신 각 프로토콜에 대해 별도의 공급자를 만듭니다.

저장된 세션, 기본 모델 및 자격 증명은 공급자 ID를 참조합니다. 이름을 바꾸려면 새 공급자를 만들고 새 기본 모델을 선택한 다음 필요한 경우 이전 설정을 마이그레이션합니다.

검색 실패 시 수동으로 모델 추가

Model catalog는 Fetch available models를 사용하여 모델 목록을 검색할 수 있습니다. 이는 호환 가능한 목록 모델 응답에 따라 달라지며 전제 조건이 아니라 편의를 위한 것입니다.

가져오기가 실패하거나 빈 목록을 반환하는 경우:

올바른 기본 URL, 프로토콜 및 API 키를 유지하세요.
TokenHub의 전체 모델 ID를 수동으로 입력하세요.
공급자를 저장하고 새 세션에서 간단한 요청을 보냅니다.
TokenHub 요청 로그에서 모델, 상태 및 사용법을 확인하십시오.

검색 실패만으로 모델을 사용할 수 없다는 의미는 아닙니다.

settings.yaml의 고급 구성

모델 페이지에는 라우팅 필드(API 키, 표시 이름, 기본 URL, 프로토콜 및 모델 ID)가 포함됩니다. $DSH_HOME/settings.yaml에서 이미지 입력, 추론 노력, 호환성 재정의, 요청 헤더, 시간 초과 및 재시도 정책을 구성합니다.

예를 들어, 정확한 모델이 지원하는 경우에만 이미지 입력을 선언하세요.

llm-pi-ai:
  providers:
    tokenhub:
      apiKeyEnv: TOKENHUB_API_KEY
      api: openai-completions
      baseURL: __API_BASE_URL__/v1
      models:
        - id: YOUR_TOKENHUB_MODEL_ID
          input: [text, image]

공식 가이드에 따르면 어댑터는 일반적으로 다시 시작하지 않고 다음 요청 시 저장된 settings.yaml 변경 사항을 읽습니다. 추측에 따라 supportsDeveloperRole 또는 maxTokensField와 같은 재정의를 추가하지 마세요. 게이트웨이가 이를 요구하거나 기본 요청을 거부하는 경우에만 이를 사용하십시오.

요청이 TokenHub에 도달하는지 확인하세요.

공급자와 모델이 모델 페이지에 저장되어 있는지 확인하세요.
새 세션을 생성하고 TokenHub 모델을 선택합니다.
파일 하나를 설명하거나 짧은 코드 블록을 요약하는 등 위험도가 낮은 작업을 실행하세요.
TokenHub 로그에서 정확한 모델 ID, 응답 상태, 사용법을 확인하세요.
그런 다음 테스트 도구, 긴 작업 및 이미지는 한 번에 하나의 기능을 입력합니다.

기존 세션은 세션 로그에 기록된 모델을 유지합니다. 기본값을 변경한 후 새 세션으로 확인하세요.

문제 해결

증상	해야 할 일
공급자 이름을 바꿔야 합니다	새 공급자를 만들고 기본 모델을 다시 선택합니다. 이름 바꾸기에 의존하지 마십시오.
사용 가능한 모델 가져오기 실패	전체 TokenHub 모델 ID를 수동으로 추가하세요. 발견은 선택 사항입니다.
404 또는 요청 형식 오류	`openai-completions`, `https://us-api.tokenhub.com/v1`를 확인하고 기본 URL에 전체 엔드포인트 경로가 없는지 확인하세요.
고급 매개변수가 적용되지 않습니다	`$DSH_HOME/settings.yaml`를 검사합니다. 기본 모델 양식에는 추론, 이미지, 시간 초과 또는 재시도 필드가 포함되어 있지 않습니다.
이전 세션은 새로운 기본값을 무시합니다	새 세션을 만듭니다. 요청이 있는 세션은 원래 모델을 유지합니다.

DeepSeek 하네스 API 설정

DeepSeek 하네스란 무엇입니까?