Una Geografía es un grupo con nombre de región de proveedor de nube dentro del cual Atlas procesa el contenido que envía a determinados servicios de Atlas. Una geografía es independiente de la región de proveedor de nube donde su clúster almacena datos.
Utilice una geografía cuando deba mostrar que Atlas procesa datos específicos dentro de una parte específica del mundo. Si no tiene tal requisito, no es necesario que seleccione una geografía.
Nota
Vista previa pública
La geografía de Europa está disponible como una funcionalidad de vista previa pública. La funcionalidad y la documentación correspondiente pueden cambiar en cualquier momento durante el período de vista previa.
Geografías y regiones de clúster
Una geografía es un concepto hermano de la región del proveedor de nube donde se ejecuta su clúster. Los dos límites son independientes y se establecen por separado:
La región rige dónde Atlas almacena los datos de tu clúster. La región del clúster es una única región de proveedor de nube, como
us-west-1oeu-west-2, que eliges cuando provisionas un clúster.Una Geografía rige dónde Atlas procesa el contenido que envía a un servicio designado. La Geografía de inferencia agrupa las regiones del proveedor de nube bajo una única jurisdicción. Lo selecciona cuando configura el servicio y permanece sin alcance hasta que lo establece.
Elegir una geografía no mueve su clúster, y elegir una región de clúster no limita su procesamiento. Debido a que estas dos configuraciones son independientes, revíselas por separado cuando evalúe dónde Atlas procesa sus datos.
Para obtener información sobre las regiones disponibles para tu clúster, consulta Proveedores de nube y regiones.
Geografías disponibles
Atlas admite las siguientes geografías:
Geografía | API Value | región | Descripción |
|---|---|---|---|
Europa |
| Espacio Económico Europeo (EEE) | El procesamiento se ejecuta en regiones de proveedores de nube dentro del EEE. |
Estados Unidos |
| Estados Unidos | El procesamiento se ejecuta en regiones de proveedores de nube dentro de los Estados Unidos. |
El conjunto de regiones dentro de una geografía puede cambiar con el tiempo. El límite de la geografía en sí no lo hace.
Servicios designados
Un Designated Service es un servicio de Atlas que respeta un ámbito geográfico. Cuando envías una solicitud con ámbito a un Designated Service, Atlas procesa esa solicitud dentro de la Geography.
La siguiente tabla enumera los servicios designados y las geografías que cada uno admite:
Servicio designado | Europa | Estados Unidos |
|---|---|---|
Servicio de Atlas Embedding and Reranking API | Sí | Sí |
Para consumir la Embedding and Reranking API de Atlas dentro de una geografía, asignas una clave de API de modelo a esa geografía cuando creas la clave. Para obtener más información, consulta Gestionar las claves de API del modelo de Voyage AI.
La incrustación automatizada y la reclasificación nativa también ejecutan inferencia en Atlas, pero aún no admiten la segmentación geográfica. No puede definir el ámbito de dónde Atlas procesa el contenido que envía a estos servicios.
Qué garantiza una geografía
Cuando envíe una solicitud a un servicio designado utilizando una clave de API de modelo con alcance geográfico, se aplican los siguientes compromisos:
Atlas procesa el contenido que envía dentro de esa geografía.
Las cargas útiles de solicitud que Atlas conserva para el registro se almacenan dentro de esa geografía.
Atlas etiqueta cada solicitud con la geografía que la sirvió, de modo que puede filtrar y auditar los registros de uso y las facturas por geografía.
Si la geografía no puede atender una solicitud, la solicitud falla. Atlas no recurre a otra geografía para servir la solicitud.
Dado que una solicitud con ámbito falla en lugar de ejecutarse en otro lugar, diseñe su aplicación para reintentar las solicitudes fallidas con retroceso y para establecer un presupuesto de reintentos en su cliente. No realice una conmutación por error a un punto de conexión de una geografía diferente a menos que el procesamiento en esa geografía sea aceptable para su caso de uso.
Una geografía restringe dónde Atlas procesa su contenido, no su cuenta. La gestión de cuentas, la gestión de claves, las políticas de recursos, la facturación y los metadatos de uso operan globalmente independientemente de la geografía que elija. Estos metadatos globales no contienen el contenido que envía para su procesamiento.
Elección de una geografía
Utiliza una clave de API de modelo sin alcance a menos que debas demostrar que Atlas procesa datos específicos dentro de una parte específica del mundo. Las claves sin alcance funcionan contra ai.mongodb.com, utilizan el mayor pool de capacidad y no están restringidas a un nivel de uso pago.
Antes de asignar el ámbito de una clave a una geografía, tenga en cuenta lo siguiente:
Atlas cobra un recargo del 10% sobre los tokens que envía a un endpoint con ámbito.
Los endpoints con ámbito requieren un nivel de uso de pago. Para obtener más información, consulta Niveles de uso.
Los endpoints con ámbito tienen sus propios límites de velocidad, que son más bajos que los del endpoint sin ámbito. Para obtener más información, consulta Gestionar límites de velocidad.
Estableces la geografía cuando creas la clave y no puedes cambiarla después. Para utilizar una geografía diferente, crea una nueva clave.
Tu organización puede requerir que se creen nuevas claves API de modelo en una geografía determinada. Para obtener más información, consulta Gestionar claves de API de modelos de Voyage AI.
Obtén más información
Para aprender cómo se aplican las geografías a la Atlas Embedding and Reranking API, incluidos los endpoints de geografía, los límites de velocidad y los modelos disponibles, consulte Geografías para la inferencia de Voyage AI en la documentación de Voyage AI.
Para aprender sobre los proveedores de nube y las regiones que Atlas admite para los clústeres, consulte proveedores de nube y regiones.