Uma Geography é um grupo nomeado de regiões de provedores de nuvem dentro do qual o Atlas processa o conteúdo que você envia para inferência por meio da Embedding and Reranking API. Uma geografia não é o mesmo que a região do provedor de nuvem onde seu cluster Atlas é executado. A região do cluster determina onde o Atlas armazena os dados do seu cluster, enquanto a Geografia de inferência determina onde o Atlas processa seu conteúdo para inferência, e você define cada um 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.
Embedding and Reranking API Pontos de Extremidade Geográficos
Cada Geografia tem seu próprio ponto de extremidade da Embedding and Reranking API. O ponto de extremidade que você chama deve corresponder à Geografia para a qual sua chave de API do modelo tem escopo.
Endpoint | Geograficamente |
|---|---|
| Não delimitado. O Atlas pode servir à solicitação de qualquer geografia. |
| Europa |
| Estados Unidos |
Pontos de extremidade com escopo seguem o padrão <geography>.ai.mongodb.com, onde <geography> é o valor geography da chave de API do modelo que você envia com a solicitação.
Para criar uma chave que não esteja no escopo de uma Geografia, defina geography como any. Para saber como as chaves e os pontos de extremidade correspondem, consulte Visão geral da Embedding and Reranking API.
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 Geografias
Pontos de extremidade com escopo não servem todos os modelos do Voyage AI. A coluna Pontos de extremidade com suporte das tabelas de modelo lista All para modelos que todos os pontos de extremidade servem e ai.mongodb.com para modelos que apenas o ponto de extremidade não delimitado serve.
Para verificar quais pontos de extremidade servem a um determinado modelo, consulte Descontinuações de modelo, estados do ciclo de vida e suporte.
Para saber mais sobre cada modelo, consulte Visão geral dos modelos de incorporação e reclassificação do Voyage AI.
Gerenciar recursos com escopo geográfico
Para trabalhar com recursos com escopo de geografia, consulte as seções a seguir:
Para criar uma chave API de modelo com escopo para uma Geografia, consulte Escopo da chave.
Para exigir que as novas chaves de API do modelo usem uma determinada Geografia, consulte Restringir o escopo da chave de API do modelo usando uma política de recurso.
Para enviar solicitações para o ponto de extremidade de uma Geografia da REST API ou de uma biblioteca de cliente, consulte Pontos de extremidade com escopo.
Para aprender como as chaves e os pontos de extremidade correspondem, consulte Pontos de extremidade.
Para revisar os limites de taxa que se aplicam a pontos de extremidade com escopo, consulte Limites de taxa de geografia.
Para realizar o filtro e segmentar seus dados de uso por geografia, consulte Uso por geografia.