Todas las plantillas Por el equipo NappAI Invocación básica (Hola, Mundo)
Interacción básica entre la entrada del usuario, la plantilla de instrucción (prompt) y la respuesta de un modelo de IA.
graph TD
%%{init: {'theme': 'mc','layout': 'elk'}}%%
ChatOutput-2qvaz[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output]
style ChatOutput-2qvaz stroke:#a170ff
GoogleGenerativeAIModel-n5twn[Google Generative AI]
style GoogleGenerativeAIModel-n5twn stroke:#a170ff
Prompt-061ik[<div><img src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt]
style Prompt-061ik stroke:#a170ff
ChatInput-3x8pa[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Input]
style ChatInput-3x8pa stroke:#a170ff
ChatInput-3x8pa -.- Prompt-061ik
linkStyle 0 stroke:#a170ff
Prompt-061ik -.- GoogleGenerativeAIModel-n5twn
linkStyle 1 stroke:#a170ff
GoogleGenerativeAIModel-n5twn -.- ChatOutput-2qvaz
linkStyle 2 stroke:#a170ff
🧩 Descripción general
El flujo permite que un usuario envíe un mensaje a través del Playground, que sea procesado por una plantilla de prompt, alimentado a Google Generative AI y finalmente mostrado de vuelta al usuario como respuesta de chat. La interacción se mantiene sencilla, facilitando la experimentación rápida con modelos de lenguaje.
⚙️ Funcionalidades principales
- Recogida de entrada: captura texto, archivos y metadatos del remitente mediante el componente de entrada de chat.
- Generación dinámica de prompt: transforma el texto del usuario en un mensaje de prompt con instrucciones predefinidas.
- Comunicación con Google Generative AI: envía el prompt y recibe una respuesta de texto basada en el modelo seleccionado.
- Salida de chat: muestra la respuesta generada al usuario con los metadatos de mensaje adecuados.
🔄 Pasos del flujo de trabajo
| Nombre del componente | Rol en el flujo | Entradas clave | Salidas clave |
|---|---|---|---|
| Chat Input | Captura la interacción inicial del usuario. | Texto del usuario, tipo de remitente, nombre del remitente, ID de sesión, ID de conversación, archivos adjuntos, opción de almacenar. | Mensaje de entrada (Message). |
| Prompt | Construye el prompt que alimentará al modelo. | Mensaje del usuario (user_input). | Prompt de mensaje (Message). |
| Google Generative AI | Genera respuesta de texto a partir del prompt. | Prompt (input_value), mensaje del sistema, configuración de streaming, modelo, número de completions, temperatura, top‑k, top‑p, máximo de tokens. | Texto de salida (text_output) (Message). |
| Chat Output | Presenta la respuesta generada al usuario. | Texto de salida del modelo (input_value). | Mensaje de salida (Message). |
🧠 Notas
- Gestión de credenciales: la clave API de Google se administra mediante el campo
credential_id; es crucial mantenerla segura y no exponerla en la documentación. - Persistencia de mensajes: el campo
should_store_messagepermite decidir si los mensajes se guardan en el historial; útil para análisis posterior. - Streaming: habilitar
streampermite recibir la respuesta en fragmentos en tiempo real, mejorando la experiencia del usuario en respuestas largas. - Modelo configurable: el selector de modelo permite cambiar entre variantes de Gemini (flash, pro, etc.) sin modificar el flujo.
- Formato de prompt: el template incluye variables (
{user_input}) que se sustituyen dinámicamente; es posible extenderlo añadiendo más campos en el futuro. - Limitaciones de tokens:
max_output_tokenscontrola la longitud máxima de la respuesta; exceder el límite puede truncar la salida. - Privacidad de archivos: los archivos enviados por el usuario se pasan al modelo solo si se incluyen explícitamente en el prompt o en los parámetros; se debe revisar el cumplimiento de la política de datos.