Observação
Visualização pública
A região geográfica da Europa e seu endpoint, eu.ai.mongodb.com, estão disponíveis como um recurso de visualização pública. O recurso e a documentação correspondente podem mudar a qualquer momento durante o período de Pré-visualização.
Uma localidade geográfica é um grupo nomeado de regiões provedor de nuvem dentro do qual o Atlas processa o conteúdo enviado para inferência por meio da API de incorporação e reclassificação. Uma localidade geográfica não é a mesma que a região do provedor de nuvem onde seu Atlas cluster é executado. A região do cluster determina onde o Atlas armazena os dados do cluster, enquanto a região de inferência determina onde o Atlas processa seu conteúdo para inferência, e você define cada uma delas separadamente.
Quando você define o escopo de uma chave de API de modelo para uma localidade, as solicitações que usam essa chave são executadas nos modelos da Voyage AI hospedados dentro dessa localidade. Para saber mais sobre o conceito de Geographie, incluindo as Geographies disponíveis e os Serviços Designados que as honram, consulte Geographies e Designated Services no Atlas.
Incorporando e reclassificando endpoints geográficos da API
Cada região tem seu próprio endpoint da API de incorporação e reclassificação. O endpoint que você chama deve corresponder à localidade geográfica para a qual a chave de API do modelo tem o escopo.
Endpoint | Geograficamente |
|---|---|
| Sem escopo. O Atlas pode atender à solicitação de qualquer localização geográfica. |
| Europa |
| Estados Unidos |
Os endpoints com escopo seguem o padrão <geography>.ai.mongodb.com, em que <geography> é o valor geography da chave de API do modelo que você envia com a solicitação.
Para criar uma chave que não tenha como escopo uma localidade geográfica,geography defina any como. Para saber como as chaves e os endpoints se correspondem, consulte Visão geral da API de incorporação e reclassificação.
Para saber o que uma localização geográfica garante e como decidir se o escopo deve ser uma chave para uma,consulte regiões e serviços designados no Atlas.
Modelos disponíveis em regiões
Os endpoints com escopo não atendem a todos os modelos de IA do Voyage. A coluna Endpoints suportados das tabelas de modelo lista All para modelos que cada endpoint atende e ai.mongodb.com para modelos que somente o endpoint sem escopo atende.
Para verificar quais endpoints atendem a um determinado modelo, consulte Itens obsoletos do modelo, estados do ciclo de vida e suporte.
Para saber mais sobre cada modelo, consulte Visão geral dos modelos.
Gerenciar recursos com escopo geográfico
Para trabalhar com recursos com escopo geográfico, consulte as seguintes seções:
Para criar uma chave de API de modelo com escopo definido para uma localização geográfica, consulte Escopo da chave.
Para exigir que as chaves de API do novo modelo usem uma determinada região, consulte Restringir o escopo da chave de API do modelo usando uma política de recursos.
Para enviar solicitações para um ponto de conexão geográfico a partir da API REST ou de uma biblioteca de cliente , consulte Pontos de conexão com escopo.
Para saber como as chaves e os pontos de conexão se correspondem, consulte Pontos de conexão.
Para revisar os limites de taxa que se aplicam aos endpoints com escopo definido, consulte Limites de taxa geográfica.
Para filtrar e segmentar seus dados de uso por localidade, consulte Uso por localidade.