Vertex AI
Vertex AI conecta tus flujos con los modelos de IA de Vertex AI, en el proyecto de Google Cloud de tu empresa. Puedes usarlo de dos formas: como el modelo de un agente, conectando su salida Model a la entrada Model del agente, o por sí solo, para que responda al texto que le llega por Input.
Cuándo usarlo
- Dar a un agente el modelo con el que entiende las peticiones, decide qué herramientas usar y responde.
- Redactar, resumir o clasificar textos dentro de un flujo, sin necesidad de un agente.
- Procesar una lista de textos uno a uno, por ejemplo todas las reseñas de un mes, con Batch Mode.
- Usar los modelos de Google dentro del proyecto de Google Cloud de tu empresa, con sus condiciones de contrato.
Configuración
En la pestaña Comun:
| Campo | Qué hace |
|---|---|
| Credentials | Sube el archivo de clave de la cuenta de servicio de tu proyecto de Google Cloud (un archivo .json). |
| Model Name | El nombre del modelo que responde. Puedes escribirlo o conectarlo desde otro componente. Por defecto: gemini-2.0-flash. |
| Temperature | Cuánta variedad tienen las respuestas: con valores bajos son más estables y previsibles; con valores altos, más creativas. Por defecto: 0.0. |
| Conexión | Qué conectar |
|---|---|
| Input | El texto al que debe responder el modelo cuando trabaja solo, por ejemplo el mensaje de un Chat Input o el resultado de un Prompt. |
Opciones avanzadas
En la pestaña Avanzado:
| Campo | Qué hace |
|---|---|
| System Message | Instrucciones generales para el modelo cuando trabaja solo: su papel, el tono, lo que debe evitar. Puedes escribirlas o conectarlas desde otro componente. |
| Stream | Muestra la respuesta en el chat a medida que se escribe, en lugar de esperar a que termine. Solo tiene efecto en el chat. Por defecto: desactivado. |
| Project | El identificador de tu proyecto de Google Cloud. Si lo dejas vacío, se toma del archivo de Credentials. |
| Location | La región de Google Cloud donde se ejecuta el modelo. Por defecto: us-central1. |
| Max Output Tokens | La longitud máxima de la respuesta, en tokens (fragmentos de palabra). |
| Max Retries | Cuántas veces se repite la petición si el servicio falla. Por defecto: 1. |
| Top K y Top P | Otras formas de controlar la variedad de la respuesta. Normalmente basta con Temperature. |
| Otras opciones | Verbose: ajustes finos para usuarios avanzados. Déjalos con su valor si no los necesitas. |
Procesamiento por lotes
Con el interruptor Batch Mode activado, el componente se ejecuta una vez por cada elemento de la lista que conectes en Batch Input y devuelve todos los resultados juntos en una lista. Parallel Executions indica cuántos elementos se procesan a la vez (de 1 a 5). Skip if Empty Batch Input salta el componente si la lista llega vacía, y Skip Branch if Empty Output detiene los componentes siguientes si el resultado está vacío. Más información en Conceptos clave.
Resultado
| Salida | Qué contiene |
|---|---|
| Model | El modelo ya configurado. Aparece en la parte superior del componente. Conéctalo a la entrada Model de un agente o de cualquier otro componente que pida un modelo. |
| Text | La respuesta del modelo al texto recibido en Input. Conéctala, por ejemplo, a un Chat Output o a otro componente que trabaje con texto. |
Las dos formas de uso se excluyen: cuando conectas la salida Model, el componente oculta Input y Text, porque el modelo pasa a trabajar dentro del otro componente; y si conectas Input, se oculta Model.
Ejemplo
El grupo Alimentación Serrano tiene sus servicios en Google Cloud. Sube el archivo de clave de su cuenta de servicio en Credentials, deja el modelo por defecto y conecta la salida Model a un agente que responde a sus proveedores.
Buenas prácticas
- Usa una Temperature baja cuando necesites respuestas exactas, como clasificar o extraer datos, y súbela para textos más creativos.
- Si vas a usar el modelo con un agente, configura aquí solo el modelo: las instrucciones y las herramientas se definen en el agente.