Alibaba Cloud Model Studio:DashScope SDK Expert

El asistente inteligente de SDK integrado en el SDK de Python de DashScope: describa su requisito para obtener código ejecutable verificado por versión, o pegue un error o ruta de archivo para diagnóstico automático, corrección y verificación.

DashScope SDK Expert (en adelante "SDK Expert") es una CLI de asistente inteligente de SDK integrada en el SDK de Python dashscope (>=1.27.3). Esta página es la guía general de uso: cómo utilizar SDK Expert para desarrollo y solución de problemas. Para conocer los parámetros completos de cada interfaz, consulte la página de referencia de la interfaz individual correspondiente en la barra lateral; los dominios de capacidad se enumeran en "Resumen de cobertura" a continuación.

Inicio rápido

1. Prepare API Key y base_url: Cree una clave (prefijo sk-) en la consola de Model Studio bajo "API Key"; las claves son específicas de la región. Configure mediante variable de entorno o /setup en la sesión:

   export DASHSCOPE_API_KEY=sk-xxxxxxxx
   export DASHSCOPE_HTTP_BASE_URL=https://{workspace-id}.{region}.maas.aliyuncs.com/api/v1
   

   base_url difiere según la región; para la asignación de dominios, consulte Resumen de URL base.

2. Instalar/Actualizar SDK: SDK Expert se introduce en el SDK de Python dashscope 1.27.3.

   # if it fails, replace pip with pip3
   pip install -U dashscope
   

3. Iniciar CLI: Ejecute dashscope (sin subcomando) para ingresar a la sesión interactiva de SDK Expert; o python -m dashscope.acli (acli es el módulo de entrada CLI de SDK Expert). En el primer inicio, se le pedirá que descargue el paquete de conocimientos de SDK Expert (incluye api-doc/diagnose y otras habilidades); o instálelo manualmente:

   dashscope
   # or manually install the SDK Expert knowledge pack
   python -m dashscope.acli example download dashscope-sdk-expert
   

4. Ver ayuda: Ingrese /help para ver todos los comandos y habilidades. Los comandos son operaciones de sesión (por ejemplo, /clear /help /exit); las habilidades son interruptores de capacidad de dominio (/skill <name>). Si tiene dudas, simplemente pregunte en lenguaje natural y SDK Expert seleccionará automáticamente una habilidad.

5. Solicitar bajo demanda: Describa su requisito en lenguaje natural, por ejemplo:

   • "Salida en streaming con qwen-plus y recuento de uso de tokens"
   • "¿Qué significa este error Throttling.RateQuota y cómo solucionarlo?"
   • "Leer gen.py y diagnosticar la causa raíz del error InvalidParameter"

   También puede usar Ctrl+T para entrada por voz, @file-path para adjuntar un archivo para que SDK Expert lo lea, y ↑ para el historial de comandos.

Resumen de cobertura

Después de instalar el paquete de conocimientos de SDK Expert, estas habilidades están disponibles (use /skill para ver todas):

skill	Uso	Ejemplo
api-doc	Consultar documentación de la API del SDK	/skill api-doc Generation
sdk-example	Generar código de ejemplo	/skill sdk-example TextEmbedding
error-code	Significado del código de error + soluciones	/skill error-code InvalidApiKey
diagnose	Leer un archivo de código, localizar la causa raíz	/skill diagnose ./my_code.py
explain-code	Explicar la lógica del código	/skill explain-code <code>
translate	Traducción multilingüe	/skill translate en hello world
update-sdk	Actualizar el índice de conocimientos	/skill update-sdk <sdk-path>

SDK Expert cubre todos los dominios de capacidad del SDK de DashScope: generación de texto, multimodal, voz, recuperación, ajuste fino e implementación, Agent, etc. Para consultar la documentación/ejemplos de una interfaz específica, use api-doc/sdk-example; para generar código o solucionar problemas, simplemente pregunte en lenguaje natural.

Mejor práctica 1: Indique solo el requisito — sin leer documentación, obtenga código ejecutable directamente

Punto de dolor: Las interfaces del SDK son numerosas y las versiones iteran rápidamente; los desarrolladores a menudo necesitan consultar la documentación para confirmar nombres de parámetros, formatos de entrada y listas de modelos.

Enfoque: Describa el requisito a SDK Expert; SDK Expert automáticamente:

1. Coincide con la base de conocimientos integrada del SDK (lista de modelos/parámetros/estructura de entrada-salida/códigos de error)
2. Verificar la versión local del SDK (recordar actualizar si hay discrepancia)
3. Generar código ejecutable y ejecutarlo realmente, mostrando la salida

Diálogo de ejemplo:

> Stream a paragraph with qwen-plus and count token usage

SDK Expert:
1. Match the api-doc/sdk-example skill, cross-check the local dashscope version
2. Generate a script and execute it, showing streaming output and token stats (see below)

import os, dashscope
dashscope.api_key = os.getenv("DASHSCOPE_API_KEY")
for chunk in dashscope.Generation.call(
    model="qwen-plus",
    messages=[{"role": "user", "content": "Write a poem about autumn"}],
    result_format="message", stream=True, incremental_output=True,
):
    if chunk.status_code == 200:
        print(chunk.output.choices[0].message.content, end="", flush=True)
# the last chunk contains usage (input/output tokens)

Autumn leaves fall... (streamed char by char)
usage: input=10 output=52

Consejos:

• Especificar lenguaje/framework: p. ej., "Envolver como un endpoint de FastAPI", "Invocar con async/await"
• Especificar versión: "Usamos dashscope 1.20.x — ¿se admite este parámetro?" — SDK Expert comprueba la versión instalada antes de responder
• Pedir detalles: "¿Rango de valores del parámetro?" "¿Qué otros modelos están disponibles?"

Mejor práctica 2: Solución de problemas — deje que localice y corrija errores automáticamente

Punto de dolor: Cuando una llamada genera un error, el significado del código de error no está claro y el seguimiento de la pila apunta a componentes internos del SDK, lo que dificulta determinar si es un problema de código o de parámetros.

Enfoque (tres caminos, elegir según el escenario):

1. Pegue el código/mensaje de error → /skill error-code <code> (por ejemplo, /skill error-code Throttling.RateQuota) → SDK Expert muestra el significado del código de error + sugerencias de solución accionables (ajustar concurrencia/modificar parámetros/solicitar cuota) + fragmento de código opcional.
2. Proporcione la ruta del archivo de código problemático → /skill diagnose <file path> (por ejemplo, /skill diagnose gen.py) → SDK Expert lee el código fuente, verifica las causas raíz comunes (mezcla de formato de prompt antiguo, estructura de mensajes incorrecta, api_key/workspace no configurado, tarea asíncrona no sondeada correctamente) y muestra la posible causa raíz + puntos de corrección sugeridos.
3. Bucle de corrección automática → /skill diagnose localiza la causa raíz → genera una vista previa de diferencias para que usted confirme → SDK Expert aplica la corrección tras la confirmación y vuelve a ejecutar el script para verificar → forma un flujo de "leer → diagnosticar → corregir → verificar". SDK Expert solicita confirmación antes de cambiar archivos y admite reversión.

Diálogo de ejemplo:

> Running gen.py throws InvalidParameter: url error, help me fix it

SDK Expert:
1. /skill diagnose gen.py → locates that image_url was passed a local path
2. Generates a diff for confirmation (see below)
3. Applies after confirmation, reruns the script, returns 200

- image_url="/tmp/photo.jpg"
+ image_url="https://example.com/photo.jpg"

Consejos:

• Adjunte request_id con el error para correlacionar los registros del lado del servidor (request_id se encuentra en el campo response.request_id del cuerpo de respuesta o en los atributos del objeto de error)
• Para problemas complejos, primero pida a SDK Expert que "explique esta lógica de código" (/skill explain-code) para confirmar una comprensión compartida antes de corregirlo
• Si el SDK en sí tiene defectos o sus necesidades no se satisfacen, registre un Issue en GitHub

FAQ

¿Modifica SDK Expert mi código fuente sin preguntar? No. Antes de cambiar archivos, SDK Expert genera una vista previa de diferencias para su confirmación; los cambios se aplican solo después de que usted confirme y admiten reversión.

¿Puede funcionar sin conexión? No. SDK Expert invoca la inferencia del modelo (consume tokens, facturados por Model Studio); requiere acceso a la red y una API Key válida.

¿Puede el código generado ejecutarse directamente en producción? SDK Expert genera código ejecutable verificado por versión, pero antes de pasar a producción debe revisar usted mismo la cuota, la concurrencia, el manejo de errores y la información sensible.

¿Puede generar código que no sea Python? Puede generar texto de código en otros lenguajes, pero no verifica las versiones del SDK que no sean de Python (esquemas de versión diferentes; revíselo usted mismo).

¿Se cargará mi código? Al diagnosticar (/skill diagnose) o adjuntar código, el contenido del código se envía al modelo para su inferencia; tenga cuidado con los datos sensibles.