Puedes gestionar la Incrustación automatizada desde la Interfaz de Usuario de Atlas.
Activar o desactivar la incrustación automatizada
Para activar la incrustación automatizada, debe crear un índice de búsqueda vectorial en MongoDB con el tipo autoEmbed. Para obtener más información, consulte Crear un índice de incrustación automatizado.
Para desactivar la incrustación automatizada a nivel de organización, utiliza una Política de recurso de Atlas. Puedes desactivar la incrustación automática por completo o desactivarla con excepciones a nivel de proyecto.
Para desactivar completamente el incrustación automatizada, utiliza la siguiente sintaxis en la política de recursos del Atlas:
forbid ( principal, action == ResourcePolicy::Action::"search.index.modify", resource ) when { context.search.index.isAutoEmbed };
Para desactivar la Incrustación Automática con excepciones para proyectos específicos, usa la siguiente sintaxis en tu Política de Recursos de Atlas. Reemplaza cada <project-id> con el ID del proyecto a eximir. Para encontrar tu ID del proyecto, consulta: Gestionar la configuración del proyecto.
forbid ( principal, action == ResourcePolicy::Action::"search.index.modify", resource ) when { context.search.index.isAutoEmbed } unless { resource in ResourcePolicy::Project::"<project-id-1>" || resource in ResourcePolicy::Project::"<project-id-2>" };
Cuando están activas, estas políticas evitan que se creen nuevos índices de tipo autoEmbed. Los índices creados antes de que se activara la política de recursos no se ven afectados y deben eliminarse manualmente para mantener el cumplimiento.
Para aplicar esta política a tu organización:
Para habilitar la incrustación automatizada, debe hacer lo siguiente:
Cree una clave de API de Voyage AI para operaciones de indexación.
Para obtener más información, consulte la sección "Administrar claves API del modelo de IA de Voyage".
Crea una clave API de Voyage AI para realizar operaciones de query.
Para obtener más información, consulte la sección "Administrar claves API del modelo de IA de Voyage".
Configure mongot para usar las claves de API.
Para obtener más información, consulte las claves de la API de Voyage AI.
Cree un tipo autoEmbed índice de Búsqueda Vectorial en MongoDB.
Para obtener más información, consulta Crear un índice de incrustación automatizado.
Ver uso de la incrustación automatizada
Para ver el uso agregado de tokens y las solicitudes de modelos de incrustación para el servicio de incrustación automatizada, puede usar el tablero de búsqueda vectorial de MongoDB o las métricas de Atlas.
Supervisar tablero
Inicia sesión en Atlas.
En Atlas, vaya a la página Search & Vector Search de su clúster.
Puedes ir a la página de búsqueda de MongoDB desde la opción Search & Vector Search o desde el Data Explorer.
Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Search & Vector Search en la sección Database.
Si el proyecto tiene varios clústeres, se debe seleccionar el clúster que se desea usar en el menú desplegable Select cluster y luego se debe hacer clic en Go to Atlas Search.
Aparece la página de Búsqueda y Búsqueda Vectorial.
Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Data Explorer en la sección Database.
Expanda la base de datos y seleccione la colección.
Haga clic en la pestaña Indexes para la colección.
Haga clic en el enlace Search and Vector Search en el banner.
Aparece la página de Búsqueda y Búsqueda Vectorial.
Haga Usage Automated Embeddingclic en en.
Se muestra la página de Uso de incrustaciones automáticas. La página de Automated Embedding Usage muestra la siguiente información:
Sección | Descripción |
|---|---|
Resumen de uso | Resumen del uso de tu incrustación automatizada, incluyendo el total de tokens utilizados y los tokens gratuitos restantes. |
Uso por modelo o índice | Desglose del uso total de tokens por modelo de incrustación o índice seleccionado durante un período de tiempo seleccionado. |
Uso por operación | Desglose de las solicitudes de token por tipo de operación (indexación y consulta). |
El siguiente procedimiento solo se aplica a las claves API creadas desde la interfaz de usuario de Atlas. Para las claves API creadas directamente desde Voyage AI, consulte Límites de uso.
Inicia sesión en Atlas.
Consulta el uso de tokens y las solicitudes del embedding model para la incrustación automatizada.
La página Usage muestra métricas de uso para todas las claves API del modelo en la organización. La página proporciona las siguientes pestañas:
Usage Activity: Muestra métricas y gráficos de uso detallados para tu organización.
Free Usage: Muestra el consumo de cuota gratuita por modelo.
Paid Usage: Muestra el uso pagado por modelo y clave de API.
Para obtener más información, consulta Funcionalidades de la página de uso.
Métricas de supervisión
Para supervisar el uso de la incrustación automatizada mediante métricas:
Inicia sesión en Atlas.
Go a la vista Metrics de tu clúster.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
Haz clic en el nombre de tu clúster para abrir la barra lateral Cluster.
En la barra lateral, haga clic en Metrics.
Selecciona el Auto Embedding Metrics para revisarlo.
Puede supervisar el uso de incrustación automatizada a través de las siguientes métricas en la sección Auto Embedding Metrics:
Métrica | Descripción |
|---|---|
Auto Embedding Index Embedding Request | El grafo de solicitudes de incrustación de índice de incrustación automática muestra el número de solicitudes para generar incrustaciones para las operaciones de indexación. Las tasas se muestran para cada modelo de incrustación en uso. |
Auto Embedding Index Tokens | El grafo de tokens de índice de incrustación automática muestra la cantidad de tokens utilizados para las operaciones de indexación. |
Auto Embedding Query Embedding Request | El grafo de solicitudes de incrustación de query de incrustación automática muestra el número de solicitudes para generar incrustaciones para las operaciones de query. |
Auto Embedding Query Tokens | El grafo de tokens de query de incrustación automática muestra el número de tokens utilizados para las operaciones de query. |
Auto Embedding Replication Lag | El grafo de atraso de la replicación de incrustación automática muestra el atraso de la replicación en milisegundos para las operaciones de indexación de incrustación automatizada. |
Para cada clúster, Atlas muestra un único grafo que agrega el uso de tokens en todos los índices de incrustación automatizada del clúster. El grafo incluye el uso de tokens tanto de la sincronización inicial como de las actualizaciones de estado estable, y muestra una línea independiente para cada modelo de incrustación que utilizan sus índices para que pueda comparar el uso de tokens por modelo.
Si implementó nodos de búsqueda para el aislamiento de la carga de trabajo, Atlas muestra este grafo en la vista de métricas Search Nodes de cada nodo de búsqueda en lugar de la vista de métricas del clúster.
Las métricas de incrustación automatizada no están disponibles para implementaciones autogestionadas.
Gestionar límites de tasa
Puede gestionar los límites de velocidad para la incrustación automatizada desde la interfaz de usuario de Atlas.
Ver límites de velocidad
Para ver los límites de tasa para la incrustación automática:
Inicia sesión en Atlas.
Ir a la página Search & Vector Search del proyecto.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Search & Vector Search bajo el encabezado Database.
Aparece la página de Búsqueda y Búsqueda Vectorial.
Haga Rate Limits Automated Embeddingclic en en.
La página muestra la siguiente información:
Nombre | Descripción |
|---|---|
Model | Lista de modelos de incrustación de Voyage IA. |
Tokens Per Minute (TPM) | Número de tokens que puedes procesar por minuto. |
Requests Per Min (RPM) | Número de solicitudes de API que puedes enviar por minuto. |
El siguiente procedimiento solo se aplica a las claves API creadas desde la interfaz de usuario de Atlas. Para las claves API creadas directamente desde Voyage AI, consulte Límites de uso.
Inicia sesión en Atlas.
Consulta los límites de tasa para la incrustación automatizada.
La página muestra la siguiente información:
Nombre | Descripción |
|---|---|
Model | Lista de modelos de incrustación de Voyage IA. |
Tokens Per Minute (TPM) | Número de tokens que puedes procesar por minuto. |
Requests Per Min (RPM) | Número de solicitudes de API que puedes enviar por minuto. |
Aumentar los límites de tasa
Si estás en el nivel gratuito y necesitas aumentar los límites de velocidad para la incrustación automatizada, añade un método de pago para pasar a un nivel de pago. Para obtener más información, consulta Establecer método de pago.
Si tienes un nivel de pago, MongoDB aumenta automáticamente los límites de velocidad a medida que aumenta tu uso. Si aún necesita un límite de tarifa más alto, póngase en contacto con Soporte de MongoDB.