En esta página, se proporciona una descripción general de la integración de Agent Platform en Spanner. La integración de Agent Platform en Spanner funciona con bases de datos de GoogleSQL y PostgreSQL.
La integración de Agent Platform en Spanner te ayuda a acceder a los modelos de AA de clasificación y regresión alojados en Agent Platform a través de la interfaz de GoogleSQL y PostgreSQL. Esto ayuda a integrar sin problemas la funcionalidad de entrega de predicciones de AA con las operaciones generales de acceso a los datos de Spanner que se realizan con consultas DQL/DML.
Beneficios de la integración de Agent Platform en Spanner
Generar predicciones de AA con la integración de Agent Platform en Spanner proporciona varios beneficios en comparación con el enfoque en el que el acceso a los datos de Spanner y el acceso al extremo de predicción de Agent Platform se realizan por separado:
- Rendimiento:
- Mejor latencia: La integración de Agent Platform en Spanner que se comunica directamente con el servicio de Agent Platform elimina los viajes de ida y vuelta adicionales entre un nodo de procesamiento que ejecuta un cliente de Spanner y el servicio de Agent Platform.
- Mejor capacidad de procesamiento/paralelismo: La integración de Agent Platform en Spanner se ejecuta sobre la infraestructura de procesamiento de consultas distribuidas de Spanner, que admite la ejecución de consultas altamente paralelizable.
- Experiencia del usuario:
- La capacidad de usar una interfaz de SQL única, simple, coherente y familiar para facilitar la transformación de datos y las situaciones de entrega de AA en el nivel de escala de Spanner reduce la barrera de entrada de AA y permite una experiencia del usuario mucho más fluida.
- Costos:
- La integración de Agent Platform en Spanner usa la capacidad de procesamiento de Spanner para combinar los resultados de los cálculos de AA y la ejecución de consulta en SQL, lo que elimina la necesidad de aprovisionar un procesamiento adicional (por ejemplo, en Compute Engine o Google Kubernetes Engine) para eso.
¿Cómo funciona la integración de Agent Platform en Spanner?
La integración de Agent Platform en Spanner no aloja modelos de AA, sino que se basa en la infraestructura de servicios de Agent Platform. No es necesario que entrenes un modelo con Agent Platform para usarlo con la integración de Agent Platform en Spanner, pero debes implementarlo en un extremo de Agent Platform.
Para entrenar modelos con datos almacenados en Spanner, puedes usar lo siguiente:
Consultas federadas de BigQuery junto con BigQuery ML.
Dataflow para exportar datos de Spanner a formato CSV y, luego, importar la fuente de datos CSV a Agent Platform.
La integración de Agent Platform en Spanner extiende las siguientes funciones para usar modelos de AA:
Genera predicciones de AA llamando a un modelo con SQL en tus datos de Spanner. Puedes usar un modelo de Model Garden de Agent Platform o un modelo implementado en tu extremo de Agent Platform.
Genera embeddings de texto para que un LLM traduzca mensajes de texto en números. Para obtener más información sobre los embeddings, consulta Obtén embeddings de texto.
Usa funciones de integración de Agent Platform en Spanner
Se puede usar un modelo en la integración de Agent Platform en Spanner para generar predicciones o embeddings de texto en tu código SQL con las funciones de ML Predict. Estas funciones son las siguientes:
GoogleSQL
Puedes usar la siguiente función de predicción de AA para GoogleSQL:
Debes registrar tu modelo con la instrucción CREATE MODEL
DDL antes de usarlo con la función ML.PREDICT.
También puedes usar SAFE.ML.PREDICT para mostrar null en lugar de un error en tus predicciones. Esto es útil en los casos en los que se ejecutan consultas grandes en las que se pueden tolerar algunas predicciones fallidas.
PostgreSQL
Puedes usar la siguiente función de predicción de AA para PostgreSQL:
Para usar las funciones, puedes seleccionar un modelo de Model Garden de Agent Platform o usar un modelo que hayas implementado en Agent Platform.
Para obtener más información sobre cómo implementar un modelo en un extremo en Agent Platform, consulta Implementa un modelo en un extremo.
Para obtener más información sobre cómo usar estas funciones para generar una predicción de AA, consulta Genera predicciones de AA con SQL.
Para obtener más información sobre cómo usar estas funciones para generar embeddings de texto, consulta Obtén embeddings de texto.
Precios
No hay cargos adicionales de Spanner cuando lo usas con la integración de Agent Platform en Spanner. Sin embargo, existen otros cargos potenciales asociados con esta función:
Pagas las tarifas estándar de la predicción en línea de Agent Platform. El cargo total depende del tipo de modelo que uses. Algunos tipos de modelos tienen una tarifa fija por hora, según el tipo de máquina y la cantidad de nodos que uses. Algunos tipos de modelos tienen tarifas por llamada. Te recomendamos que implementes este último en un proyecto dedicado en el que hayas establecido cuotas de predicción explícitas.
Pagas las tarifas estándar de la transferencia de datos entre Spanner y Agent Platform. El cargo total depende de la región que aloja el servidor que ejecuta la consulta y la región que aloja el extremo llamado. Para minimizar los cargos, implementa tus extremos de Agent Platform en la misma región que tu instancia de Spanner. Cuando uses configuraciones de instancias multirregionales o varios extremos de Agent Platform, implementa tus extremos en el mismo continente.
ANS
Debido a que la disponibilidad de la predicción en línea de Agent Platform es menor, debes configurar correctamente los modelos de AA de Spanner para mantener la alta disponibilidad de Spanner mientras usas la integración de Agent Platform en Spanner:
- Los modelos de AA de Spanner deben usar varios extremos de Agent Platform en el backend para habilitar la conmutación por error.
- Los extremos de Agent Platform deben cumplir con el ANS de Agent Platform.
- Los extremos de Agent Platform deben aprovisionar suficiente capacidad para controlar el tráfico entrante.
- Los extremos de Agent Platform deben usar regiones separadas cerca de la base de datos de Spanner para evitar interrupciones regionales.
- Los extremos de Agent Platform deben usar proyectos separados para evitar problemas con las cuotas de predicción por proyecto.
La cantidad de extremos redundantes de Agent Platform depende de su ANS y de la cantidad de filas en las consultas de Spanner:
| ANS de Spanner | ANS de Agent Platform | 1 fila | 10 filas | 100 filas | 1,000 filas |
|---|---|---|---|---|---|
| 99.99% | 99.9% | 2 | 2 | 2 | 3 |
| 99.99% | 99.5% | 2 | 3 | 3 | 4 |
| 99.999% | 99.9% | 2 | 2 | 3 | 3 |
| 99.999% | 99.5% | 3 | 3 | 4 | 4 |
Los extremos de Agent Platform no necesitan alojar exactamente el mismo modelo. Te recomendamos que configures el modelo de AA de Spanner para que tenga un modelo principal, complejo y de uso intensivo de procesamiento como su primer extremo. Los extremos de conmutación por error posteriores pueden apuntar a modelos simplificados que sean menos intensivos en procesamiento, se escalen mejor y puedan absorber los aumentos repentinos de tráfico.
Limitaciones
- La entrada y la salida del modelo deben ser un objeto JSON.
Cumplimiento
Assured Workloads no admite la API de Prediction de Agent Platform. Si habilitas una restricción de uso de recursos , se inhabilita la API de Agent Platform y, de manera efectiva, la función de integración de Agent Platform en Spanner.
Además, te recomendamos que crees un perímetro de Controles del servicio de VPC para asegurarte de que tus bases de datos de producción no puedan conectarse a los extremos de Agent Platform en tus proyectos que no sean de producción y que podrían no tener la configuración de cumplimiento adecuada.