Estrutura de Objeto do Azure OpenAI
Integrar o Azure OpenAI Service com sua aplicação permite que você utilize perfeitamente múltiplas implantações e modelos de região hospedados pelo Azure OpenAI. Esta seção detalha como configurar o endpoint do Azure OpenAI para suas necessidades.
Para um guia detalhado sobre como configurar as definiƧƵes do Azure OpenAI, clique aqui
Exemplo de Configuração
endpoints:
azureOpenAI:
titleModel: "gpt-4-turbo"
groups:
- group: "my-westus" # arbitrary name
apiKey: "${WESTUS_API_KEY}"
instanceName: "actual-instance-name" # name of the resource group or instance
version: "2023-12-01-preview"
# baseURL: https://prod.example.com
# additionalHeaders:
# X-Custom-Header: value
models:
gpt-4-vision-preview:
deploymentName: gpt-4-vision-preview
version: "2024-02-15-preview"
gpt-3.5-turbo:
deploymentName: gpt-35-turbo
gpt-3.5-turbo-1106:
deploymentName: gpt-35-turbo-1106
gpt-4:
deploymentName: gpt-4
gpt-4-1106-preview:
deploymentName: gpt-4-1106-preview
- group: "my-eastus"
apiKey: "${EASTUS_API_KEY}"
instanceName: "actual-eastus-instance-name"
deploymentName: gpt-4-turbo
version: "2024-02-15-preview"
baseURL: "https://gateway.ai.cloudflare.com/v1/cloudflareId/azure/azure-openai/${INSTANCE_NAME}/${DEPLOYMENT_NAME}" # uses env variables
additionalHeaders:
X-Custom-Header: value
models:
gpt-4-turbo: trueNota: O endpoint do Azure OpenAI suporta todas as ConfiguraƧƵes de Endpoint Compartilhadas, incluindo
streamRate,titleModel,titleMethod,titlePrompt,titlePromptTemplateetitleEndpoint.
assistants
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| assistants | Boolean | Habilita ou desabilita assistentes para o endpoint Azure OpenAI. Quando definido como `true`, ativa os assistentes associados a este endpoint. | Choose one, either the official OpenAI API or Azure OpenAI API for assistants, not both. |
Padrão: Não especificado
Exemplo:
assistants: truegroups
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| groups | Array | Configuração para grupos de modelos por localização geogrÔfica ou finalidade. Cada item no array `groups` configura um conjunto de modelos sob um determinado agrupamento, geralmente por região geogrÔfica ou configuração distinta. |
Padrão: Não especificado
Nota: Veja o exemplo acima.
Estrutura do Objeto de Grupo
Cada item em groups faz parte de uma lista de registros, cada um com os seguintes campos:
group
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| group | String | Identificador para um grupo de modelos. |
Obrigatório: sim
Exemplo:
"group": "my-westus"apiKey
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| apiKey | String | A chave de API para acessar o Azure OpenAI Service. | It's highly recommended to use a custom env. variable reference for this field, i.e. `${YOUR_VARIABLE}` |
Obrigatório: sim
Exemplo:
apiKey: "${WESTUS_API_KEY}"instanceName
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| instanceName | String | Nome da instĆ¢ncia do Azure. **Suporta ambos os formatos de domĆnio**: `.openai.azure.com` (legado) e `.cognitiveservices.azure.com` (novo). VocĆŖ pode especificar o domĆnio completo (por exemplo, `my-instance.cognitiveservices.azure.com`) ou apenas o nome da instĆ¢ncia (por exemplo, `my-instance`) para compatibilidade com versƵes anteriores com o formato legado `.openai.azure.com`. | It's recommended to use a custom env. variable reference for this field, i.e. `${YOUR_VARIABLE}` |
Obrigatório: sim
Exemplo:
# Using just the instance name (legacy format applied)
instanceName: "my-westus"
# OR using the full domain (new format)
instanceName: "my-westus.cognitiveservices.azure.com"version
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| version | String | Versão da API. | It's recommended to use a custom env. variable reference for this field, i.e. `${YOUR_VARIABLE}` |
Padrão: Não especificado
Exemplo:
version: "2023-12-01-preview"baseURL
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| baseURL | String | A URL base para o Azure OpenAI Service. | It's recommended to use a custom env. variable reference for this field, i.e. `${YOUR_VARIABLE}` |
Padrão: Não especificado
Exemplo:
baseURL: "https://prod.example.com"additionalHeaders
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| additionalHeaders | Dictionary | CabeƧalhos adicionais para solicitaƧƵes de API. Todos os valores de cabeƧalho devem ser strings. | It's recommended to use a custom env. variable reference for the values of field, as shown in the example. `api-key` header value is sent on every request. |
Padrão: Não especificado
Exemplo:
additionalHeaders:
X-Custom-Header: ${YOUR_SECRET_CUSTOM_VARIABLE}serverless
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| serverless | Boolean | Indica o uso de um endpoint de inferĆŖncia serverless para chat completions do Azure OpenAI. Quando definido como `true`, especifica que o grupo estĆ” configurado para usar endpoints de inferĆŖncia serverless como um modelo "Models as a Service" do Azure. | More info [here](../ai_endpoints/azure.mdx#serverless-inference-endpoints) |
Padrão: Não especificado
Exemplo:
serverless: trueaddParams
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| addParams | Object/Dictionary | Adiciona parĆ¢metros adicionais Ć s solicitaƧƵes. Ćtil para especificar opƧƵes especĆficas da API. |
Padrão: Não especificado
Exemplo:
addParams:
safe_prompt: truedropParams
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| dropParams | Array/List of Strings | Remove parâmetros padrão das requisições. Exclui os parâmetros padrão especificados. | Default parameters are the standard request parameters LibreChat sends to the Azure OpenAI API. |
Padrão: Não especificado
Exemplo:
dropParams: ["stop", "user", "frequency_penalty", "presence_penalty"]models
Chave:
| Key | Type | Description | Example |
|---|---|---|---|
| models | Configuração para modelos individuais dentro de um grupo. Define as configurações para cada modelo, incluindo o nome da implantação e a versão. | Model configurations can adopt the group's deployment name and/or version when configured as a boolean (set to `true`) or an object for detailed settings of either of those fields. |
Padrão: Não especificado
Exemplo:
models:
gpt-4-vision-preview:
deploymentName: "arbitrary-deployment-name"
version: "2024-02-15-preview"Como estĆ” este guia?