Skip to content

set-up-azure-ai.md

Latest commit

 

History

History
121 lines (75 loc) · 6.34 KB

set-up-azure-ai.md

File metadata and controls

121 lines (75 loc) · 6.34 KB

Configurar Azure AI para Co-op Translator (Azure OpneAI & Azure AI Vision)

Este guia orienta você na configuração do Azure OpenAI para tradução de idiomas e do Azure Computer Vision para análise de conteúdo de imagens (que pode ser usada para tradução baseada em imagens) dentro do Azure AI Foundry.

Pré-requisitos:

  • Uma conta Azure com uma assinatura ativa.
  • Permissões suficientes para criar recursos e implantações em sua assinatura Azure.

Criar um Projeto Azure AI

Você começará criando um Projeto Azure AI, que serve como um local central para gerenciar seus recursos de IA.

  1. Navegue para https://ai.azure.com e faça login com sua conta Azure.

  2. Selecione +Create para criar um novo projeto.

  3. Execute as seguintes tarefas:

    • Insira um Nome do projeto (por exemplo, CoopTranslator-Project).
    • Selecione o AI hub (por exemplo, CoopTranslator-Hub) (Crie um novo se necessário).

  4. Clique em "Review and Create" para configurar seu projeto. Você será levado para a página de visão geral do seu projeto.

Configurar Azure OpenAI para Tradução de Idiomas

Dentro do seu projeto, você implantará um modelo Azure OpenAI para servir como backend para tradução de texto.

Navegar para seu Projeto

Se ainda não estiver, abra seu projeto recém-criado (por exemplo, CoopTranslator-Project) no Azure AI Foundry.

Implantar um Modelo OpenAI

  1. No menu à esquerda do seu projeto, em "My assets", selecione "Models + endpoints".

  2. Selecione + Deploy model.

  3. Selecione Deploy Base Model.

  4. Será apresentada uma lista de modelos disponíveis. Filtre ou pesquise por um modelo GPT adequado. Recomendamos gpt-4o.

  5. Selecione o modelo desejado e clique em Confirm.

  6. Selecione Deploy.

Configuração do Azure OpenAI

Após a implantação, você pode selecionar a implantação na página "Models + endpoints" para encontrar sua URL do endpoint REST, Chave, Nome da implantação, Nome do modelo e Versão da API. Estes serão necessários para integrar o modelo de tradução à sua aplicação.

Note

Você pode selecionar versões da API na página API version deprecation conforme suas necessidades. Esteja ciente de que a versão da API é diferente da versão do Modelo exibida na página Models + endpoints no Azure AI Foundry.

Configurar Azure Computer Vision para Tradução de Imagem

Para habilitar a tradução de texto dentro de imagens, você precisa encontrar a Chave de API e o Endpoint do Serviço Azure AI.

  1. Navegue para seu Projeto Azure AI (por exemplo, CoopTranslator-Project). Certifique-se de estar na página de visão geral do projeto.

Configuração do Serviço Azure AI

Encontre a Chave de API e o Endpoint no Serviço Azure AI.

  1. Navegue para seu Projeto Azure AI (por exemplo, CoopTranslator-Project). Certifique-se de estar na página de visão geral do projeto.

  2. Encontre a Chave da API e o Endpoint na aba Azure AI Service.

    Find API Key and Endpoint

Esta conexão torna as capacidades do recurso vinculado do Azure AI Services (incluindo análise de imagens) disponíveis para seu projeto AI Foundry. Você pode então usar esta conexão em seus notebooks ou aplicações para extrair texto das imagens, que posteriormente podem ser enviadas para o modelo Azure OpenAI para tradução.

Consolidando Suas Credenciais

Até agora, você deve ter coletado o seguinte:

Para Azure OpenAI (Tradução de Texto):

  • Endpoint Azure OpenAI
  • Chave API Azure OpenAI
  • Nome do Modelo Azure OpenAI (exemplo, gpt-4o)
  • Nome da Implantação Azure OpenAI (exemplo, cooptranslator-gpt4o)
  • Versão da API Azure OpenAI

Para Azure AI Services (Extração de Texto de Imagem via Vision):

  • Endpoint Azure AI Service
  • Chave API Azure AI Service

Exemplo: Configuração de Variáveis de Ambiente (Preview)

Mais tarde, ao construir sua aplicação, provavelmente a configurará usando essas credenciais coletadas. Por exemplo, você pode defini-las como variáveis de ambiente assim:

# Credenciais do Serviço Azure AI (Obrigatório para tradução de imagem)
AZURE_AI_SERVICE_API_KEY="your_azure_ai_service_api_key" # Exemplo: 21xasd...
AZURE_AI_SERVICE_ENDPOINT="https://your_azure_ai_service_endpoint.cognitiveservices.azure.com/"

# Conjuntos de fallback opcionais: duplicar variáveis com sufixo _1/_2 (mesmo índice para todas as variáveis do conjunto)
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.cognitiveservices.azure.com/"

# Credenciais Azure OpenAI (Obrigatório para tradução de texto)
AZURE_OPENAI_API_KEY="your_azure_openai_api_key" # Exemplo: 21xasd...
AZURE_OPENAI_ENDPOINT="https://your_azure_openai_endpoint.openai.azure.com/"
AZURE_OPENAI_MODEL_NAME="your_model_name" # Exemplo: gpt-4o
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME="your_deployment_name" # Exemplo: cooptranslator-gpt4o
AZURE_OPENAI_API_VERSION="your_api_version" # Exemplo: 2024-12-01-preview

# Conjuntos de fallback opcionais: duplicar o conjunto completo AZURE_OPENAI_* com sufixo _1/_2 (mesmo índice para todas as variáveis)

Leituras adicionais

Aviso Legal:
Este documento foi traduzido usando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em sua língua nativa deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.