Neste tutorial, vamos guiá-lo na configuração das suas variáveis de ambiente para serviços Azure usando um ficheiro .env. As variáveis de ambiente permitem-lhe gerir de forma segura credenciais sensíveis, como chaves de API, sem as ter codificadas diretamente na sua base de código.
[!IMPORTANT]
- Apenas um serviço de modelo de linguagem (Azure OpenAI ou OpenAI) precisa de ser configurado. Preencha as variáveis de ambiente para o serviço que preferir. Se as variáveis de ambiente de vários modelos de linguagem estiverem definidas, o co-op translator irá selecionar um com base na prioridade.
- Se as variáveis de ambiente do Computer Vision não estiverem definidas, o tradutor irá alternar automaticamente para o modo apenas Markdown.
[!NOTE] Este guia foca-se principalmente nos serviços Azure, mas pode escolher qualquer modelo de linguagem suportado da lista de modelos e serviços suportados.
No diretório raiz do seu projeto, crie um ficheiro chamado .env. Este ficheiro irá armazenar todas as suas variáveis de ambiente num formato simples.
[!WARNING] Não faça commit do seu ficheiro .env em sistemas de controlo de versões como o Git. Adicione .env ao seu ficheiro .gitignore para evitar commits acidentais.
Navegue até ao diretório raiz do seu projeto.
Crie um ficheiro .env no diretório raiz do seu projeto.
Abra o ficheiro .env e cole o seguinte modelo:
# Azure Credentials
AZURE_AI_SERVICE_API_KEY="your_azure_ai_service_api_key"
AZURE_AI_SERVICE_ENDPOINT="https://your_azure_ai_service_endpoint"
# Optional fallback set example (index 1)
AZURE_AI_SERVICE_API_KEY_1="your_azure_ai_service_api_key_1"
AZURE_AI_SERVICE_ENDPOINT_1="https://your_azure_ai_service_endpoint_1"
# Azure OpenAI Credentials
AZURE_OPENAI_API_KEY="your_azure_openai_api_key"
AZURE_OPENAI_ENDPOINT="https://your_azure_openai_endpoint"
AZURE_OPENAI_MODEL_NAME="your_model_name"
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME="your_deployment_name"
AZURE_OPENAI_API_VERSION="your_api_version"
# Optional fallback sets: duplicate the full AZURE_OPENAI_* set with suffix _1/_2 (same index for all variables)
# OpenAI Credentials
OPENAI_API_KEY="your_openai_api_key"
OPENAI_ORG_ID="your_openai_org_id"
OPENAI_CHAT_MODEL_ID="your_chat_model_id(ex. gpt-4o)"
OPENAI_BASE_URL="https://api.openai.com/v1 (If you don't have a custom base URL, you can delete this lin, then it will use the default base URL)"
# Optional fallback sets: duplicate the full OPENAI_* set with suffix _1/_2 (same index for all variables)
[!NOTE] Se quiser encontrar as suas chaves API e endpoints, pode consultar set-up-azure-ai.md.
Aviso Legal:
Este documento foi traduzido utilizando o serviço de tradução automática Co-op Translator. Embora nos esforcemos por garantir a precisão, por favor esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução profissional por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.