Saltearse al contenido
Nappai Documentation

Deepseek

Deepseek is a component that lets you generate text with Deepseek language models. It connects to the Deepseek API and lets you control how many tokens you want, how random the output is, and whether you want the response streamed. You can also use it in batch mode to process many records at once.

¿Cómo funciona?

The component talks to the Deepseek API (https://api.deepseek.com) using the OpenAI‑compatible interface. When you run the component, it builds a ChatOpenAI model with the settings you choose. It then sends your input text to the model and returns the generated text. If you enable streaming, the text comes back piece by piece. The component also logs the interaction through LLMCallbackHandler so you can see what happened in the dashboard.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

  • Input: El dato que se enviará al modelo para generar una respuesta.
  • Mapping Mode: Interruptor que activa el modo de mapeo para procesar varios registros a la vez.
  • Max Tokens: Maximum number of tokens to generate. Set to 0 for unlimited.
  • Model Kwargs: Additional keyword arguments that are passed directly to the model.
  • Model Name: Select the Deepseek model you want to use.
  • Seed: The seed controls the reproducibility of the job.
  • Stream: Stream the response from the model. Streaming works only in Chat.
  • System Message: System message to pass to the model.
  • Temperature: Controls how random the output is (lower = more deterministic).

Credencial
Para usar este componente necesitas una credencial de tipo Deepseek API.

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada “Deepseek API”.
  2. Ingresa tu Deepseek API Key.
  3. En el componente, selecciona esa credencial en el campo “Credential”.

Salidas

  • Text: El texto generado por el modelo (tipo Message, método text_response).
  • Model: El objeto LanguageModel construido (tipo LanguageModel, método build_model). Puedes usarlo en otros componentes que requieran un modelo.

Ejemplo de Uso

Supongamos que quieres generar un resumen de un artículo:

  1. Arrastra el componente Deepseek al flujo.
  2. Desactiva “Mapping Mode” si solo procesas un artículo.
  3. En Input escribe el texto del artículo.
  4. En Model Name elige “deepseek-coder-v2” (o el que prefieras).
  5. Ajusta Max Tokens a 200 y Temperature a 0.2.
  6. Selecciona la credencial “Deepseek API” que creaste.
  7. Ejecuta el flujo.
  8. El resultado aparecerá en la salida Text y podrás usarlo en un componente de “Display” o “Send Email”.

Componentes Relacionados

  • ChatOpenAI: La clase que se usa internamente para comunicarse con Deepseek.
  • LLMCallbackHandler: Registra la conversación y permite ver logs en el dashboard.
  • Deepseek API Credential: Configura tu clave de acceso.

Consejos y Mejores Prácticas

  • Usa Max Tokens razonables para evitar costos innecesarios.
  • Si necesitas respuestas rápidas, activa Stream y procesa el texto a medida que llega.
  • Para tareas repetitivas, habilita “Mapping Mode” y conecta la salida de un componente de “List” para procesar varios ítems a la vez.
  • Ajusta Temperature según la creatividad que necesites: valores bajos (0.1‑0.3) generan respuestas más coherentes, valores altos (0.7‑1.0) son más creativos.
  • Guarda la credencial en la sección de credenciales y no la expongas en el flujo.

Consideraciones de Seguridad

  • La clave de la API se almacena de forma segura en la sección de credenciales; no la incluyas en el flujo.
  • Si compartes el flujo con otros usuarios, asegúrate de que tengan acceso a la credencial o crea una nueva credencial con permisos limitados.
  • Revisa los límites de uso de Deepseek para evitar sobrepasar cuotas y posibles cargos adicionales.