Plan de Integración de DeepSeek Harness

Este documento es aplicable a deepseek-harness-sdk==0.1.0rc6 y deepseek-harness-runtime-bin==0.1.0rc6. Después de actualizar el cliente, complete nuevamente la prueba de archivo de solo lectura a continuación.

​

Alcance de Soporte

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

​

1. Preparar la Clave Exclusiva

export ACEDATACLOUD_API_KEY="PEGA_TU_CLAVE_DE_CODIFICACIÓN_AQUÍ"
export DEEPSEEK_BASE_URL="https://api.acedata.cloud/v1"
export DEEPSEEK_API_KEY="$ACEDATACLOUD_API_KEY"

​

2. Crear un Espacio de Trabajo Aislado

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. Ejecutar el SDK de Python Oficial

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

​

Preguntas Frecuentes

• 401: Verifique si ACEDATACLOUD_API_KEY está exportado al mismo shell que ejecuta Python.
• 403 o aviso de cuota: Confirme que la clave pertenece a la Aplicación de Codificación actual, que el paquete sigue siendo válido y que hay saldo restante.
• Modelo no disponible: Vuelva a consultar /v1/models, no adivine el nombre del modelo basándose en capturas de pantalla antiguas.
• Error en reasoning_content / reproducción de herramientas: Confirme que tanto el SDK como el runtime son la versión fija de este documento y que está utilizando deepseek-v4-pro.
• Número de ejecuciones de herramientas anómalo: Detenga la ejecución de tareas que puedan tener efectos secundarios, primero valide la versión actual del servicio con el fixture de solo lectura de este documento.
• Instalación fallida: Confirme que Python 3.10+, la arquitectura del sistema operativo son compatibles con el wheel actual, y verifique que las versiones del SDK/runtime sean consistentes.

​

Límites de Capacidades

​

Referencias Oficiales

• Repositorio de DeepSeek Harness
• SDK de Python de DeepSeek Harness