Piano di integrazione di DeepSeek Harness

Questo documento è applicabile a deepseek-harness-sdk==0.1.0rc6 e deepseek-harness-runtime-bin==0.1.0rc6. Dopo aver aggiornato il client, completare nuovamente il test del file di sola lettura qui sotto.

​

Ambito di supporto

curl https://api.acedata.cloud/v1/models \
  -H "Authorization: Bearer $ACEDATACLOUD_API_KEY"

​

1. Preparare la chiave esclusiva

export ACEDATACLOUD_API_KEY="INSERISCI_LA_TUA_CHIAVE_CODIFICA_QUI"
export DEEPSEEK_BASE_URL="https://api.acedata.cloud/v1"
export DEEPSEEK_API_KEY="$ACEDATACLOUD_API_KEY"

​

2. Creare un’area di lavoro isolata

mkdir -p /tmp/deepseek-harness-demo/workspace
mkdir -p /tmp/deepseek-harness-demo/sessions
printf 'compatibility fixture\n' > /tmp/deepseek-harness-demo/workspace/fixture.txt
python3 -m venv /tmp/deepseek-harness-demo/venv
/tmp/deepseek-harness-demo/venv/bin/pip install \
  "deepseek-harness-sdk==0.1.0rc6"

​

3. Eseguire l’SDK Python ufficiale

import os

from deepseek_harness import DeepSeekHarness

with DeepSeekHarness(
    provider="deepseek-official",
    model="deepseek-v4-pro",
    max_tokens=160,
    cwd="/tmp/deepseek-harness-demo/workspace",
    session_root="/tmp/deepseek-harness-demo/sessions",
    base_url=os.environ["DEEPSEEK_BASE_URL"],
    api_key=os.environ["DEEPSEEK_API_KEY"],
    request_timeout_seconds=180,
) as harness:
    result = harness.run(
        "Read fixture.txt once, then reply with exactly: sdk-harness-ok",
        session_id="acedatacloud-compat",
    )

print(result.final_response)
print(result.finish_reason)

/tmp/deepseek-harness-demo/venv/bin/python \
  /tmp/deepseek-harness-demo/run.py

sdk-harness-ok
completed

​

Domande frequenti

• 401: Controllare se ACEDATACLOUD_API_KEY è esportato nella stessa shell in cui viene eseguito Python.
• 403 o avviso di quota: Confermare che la chiave appartenga all’attuale applicazione di codifica, che il pacchetto sia ancora valido e che ci sia un saldo residuo.
• Modello non disponibile: Interrogare nuovamente /v1/models, non indovinare il nome del modello in base a vecchie schermate.
• Errore reasoning_content / riproduzione degli strumenti: Confermare che SDK/runtime siano entrambi della versione fissa di questo documento e utilizzare deepseek-v4-pro.
• Numero di esecuzioni degli strumenti anomalo: Interrompere l’esecuzione di attività che potrebbero avere effetti collaterali, prima utilizzare il fixture di sola lettura di questo documento per verificare la versione attuale del servizio.
• Installazione fallita: Confermare che Python 3.10+, l’architettura del sistema operativo siano supportati dall’attuale wheel e controllare che le versioni di SDK/runtime siano coerenti.

​

Limiti delle capacità

​

Riferimenti ufficiali

• Repository di DeepSeek Harness
• SDK Python di DeepSeek Harness