Skip to main content
DeepSeek Harness to agent programistyczny działający lokalnie. Odczytuje on przestrzeń roboczą, wywołuje narzędzia i wykonuje polecenia, a następnie korzysta z interfejsu OpenAI-compatible Chat Completions do wywołania modelu.
Ten dokument dotyczy deepseek-harness-sdk==0.1.0rc6 oraz deepseek-harness-runtime-bin==0.1.0rc6. Po aktualizacji klienta, proszę ponownie wykonać testy plików tylko do odczytu poniżej.

Zakres wsparcia

Katalog modeli może się zmieniać. Przed uruchomieniem, użyj dedykowanego klucza Coding Plan, aby sprawdzić aktualny katalog:
Upewnij się, że odpowiedź zawiera deepseek-v4-pro. Nie traktuj deepseek-v4-flash jako równoważnego zamiennika dla trybu narzędzi opisanego w tym dokumencie; w tej wersji walidacji, jego historia wnioskowania wieloetapowego i odtwarzanie narzędzi nie przeszły.

1. Przygotowanie dedykowanego klucza

Otwórz aplikację Coding Plan, przejdź do zakupionej aplikacji Coding, utwórz lub skopiuj dedykowany klucz API tej aplikacji. Coding Plan nie korzysta z ogólnego salda, klucze innych aplikacji nie mogą reprezentować uprawnień pakietu. Umieść klucz tylko w bieżącym shellu:
Nie zapisuj prawdziwego klucza w skryptach, repozytoriach konfiguracyjnych, zrzutach ekranu terminala ani w rejestrach sesji.

2. Utworzenie izolowanej przestrzeni roboczej

Bundlowany runtime Harness zawiera lokalne narzędzia Bash. Podczas pierwszej walidacji nie wskazuj na prawdziwe projekty ani katalog główny; utwórz jednorazowy katalog bez tajemnic:
Jeśli sieć firmowa korzysta z prywatnego obrazu PyPI, upewnij się, że w obrazie znajduje się ta sama wersja deepseek-harness-runtime-bin. Nie używaj danger-full-access, aby rozszerzyć zakres dostępu do plików; przykład w tym dokumencie przekazuje jednorazowy katalog tylko do cwd.

3. Uruchomienie oficjalnego SDK Pythona

Zapisz poniższy kod jako /tmp/deepseek-harness-demo/run.py:
Uruchom:
Oczekiwany wynik:
Ten krok jednocześnie weryfikuje autoryzację Bearer, /v1/chat/completions, SSE, treść wnioskowania, wywołania narzędzi i zwrot wyników narzędzi. Po zakończeniu można usunąć /tmp/deepseek-harness-demo; jeśli katalog sesji zawiera kontekst projektu, powinien być przechowywany z takim samym poziomem wrażliwości jak repozytorium kodu.

Często zadawane pytania

  • 401: Sprawdź, czy ACEDATACLOUD_API_KEY jest wyeksportowany do tego samego shellu, w którym uruchamiasz Pythona.
  • 403 lub komunikat o limitach: Upewnij się, że klucz należy do bieżącej aplikacji Coding, pakiet jest nadal ważny i ma dostępne limity.
  • Model niedostępny: Ponownie sprawdź /v1/models, nie zgaduj nazwy modelu na podstawie starych zrzutów ekranu.
  • Błąd reasoning_content / odtwarzania narzędzi: Upewnij się, że SDK/runtime są w wersji opisanej w tym dokumencie i używają deepseek-v4-pro.
  • Nieprawidłowa liczba wykonanych narzędzi: Zatrzymaj uruchamianie zadań, które mogą powodować skutki uboczne, najpierw zweryfikuj bieżącą wersję usługi za pomocą tylko do odczytu fixture.
  • Niepowodzenie instalacji: Upewnij się, że Python 3.10+, architektura systemu operacyjnego jest wspierana przez bieżące koło, i sprawdź, czy wersje SDK/runtime są zgodne.

Granice możliwości

Ten dokument weryfikuje tylko lokalne SDK Pythona do tekstu i pętli narzędzi Chat Completions. Obrazy, API plików, /v1/responses, /v1/messages, zdalne przestrzenie robocze i zarządzane sandboxy nie są objęte zakresem tego samouczka; uprawnienia przestrzeni roboczej i ryzyko lokalnych poleceń są odpowiedzialnością maszyny uruchamiającej Harness oraz konfiguracji.

Oficjalne odniesienia

Powrót do Centrum konfiguracji Coding Plan.