co-op-translator

Configurar o Azure AI para Co-op Translator (Azure OpenAI & 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 usado para tradução baseada em imagens) dentro do Azure AI Foundry.

Pré-requisitos:

Criar um Projeto Azure AI

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

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

  2. Selecione +Create para criar um novo projeto.

  3. Realize as seguintes tarefas:
    • Insira um Nome do projeto (ex.: CoopTranslator-Project).
    • Selecione o AI hub (ex.: CoopTranslator-Hub) (crie um novo, se necessário).
  4. Clique em “Review and Create” para configurar seu projeto. Você será direcionado para a página de visão geral do seu projeto.

Configurar o 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.

Se ainda não estiver lá, abra seu projeto recém-criado (ex.: 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. Escolha Deploy Base Model.

  4. Será exibida 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. Clique em 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, Key, Nome da implantação, Nome do modelo e Versão da API. Esses dados serão necessários para integrar o modelo de tradução ao seu aplicativo.

[!NOTE] Você pode escolher versões da API na página de API version deprecation conforme suas necessidades. Lembre-se que a versão da API é diferente da versão do modelo exibida na página Models + endpoints no Azure AI Foundry.

Configurar o Azure Computer Vision para Tradução de Imagens

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

  1. Acesse seu Projeto Azure AI (ex.: CoopTranslator-Project). Certifique-se de estar na página de visão geral do projeto.

Configuração do Azure AI Service

Encontre a Chave da API e o Endpoint no Azure AI Service.

  1. Acesse seu Projeto Azure AI (ex.: CoopTranslator-Project). Certifique-se de estar na página de visão geral do projeto.

  2. Localize a API Key e o Endpoint na aba Azure AI Service.

    Find API Key and Endpoint

Essa conexão torna as capacidades do recurso Azure AI Services vinculado (incluindo análise de imagens) disponíveis para seu projeto no AI Foundry. Você poderá usar essa conexão em seus notebooks ou aplicações para extrair texto de imagens, que depois pode ser enviado ao modelo Azure OpenAI para tradução.

Consolidando suas Credenciais

Até aqui, você deve ter reunido o seguinte:

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

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

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

Mais adiante, ao construir seu aplicativo, provavelmente você irá configurá-lo usando essas credenciais coletadas. Por exemplo, você pode defini-las como variáveis de ambiente assim:

# Azure AI Service Credentials (Required for image translation)
AZURE_AI_SERVICE_API_KEY="your_azure_ai_service_api_key" # e.g., 21xasd...
AZURE_AI_SERVICE_ENDPOINT="https://your_azure_ai_service_endpoint.cognitiveservices.azure.com/"

# Azure OpenAI Credentials (Required for text translation)
AZURE_OPENAI_API_KEY="your_azure_openai_api_key" # e.g., 21xasd...
AZURE_OPENAI_ENDPOINT="https://your_azure_openai_endpoint.openai.azure.com/"
AZURE_OPENAI_MODEL_NAME="your_model_name" # e.g., gpt-4o
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME="your_deployment_name" # e.g., cooptranslator-gpt4o
AZURE_OPENAI_API_VERSION="your_api_version" # e.g., 2024-12-01-preview

Leitura Complementar

Aviso Legal:
Este documento foi traduzido utilizando 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 automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo 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.