Risorse di Azure per Translator

• Una risorsa Foundry è lo strumento principale per la creazione, la distribuzione e la gestione di applicazioni e agenti di intelligenza artificiale generativi. Con questa risorsa è possibile accedere ai servizi agente, usare modelli ospitati in un ambiente serverless, eseguire valutazioni e connettersi al servizio Azure OpenAI.
  

• Se si prevede di usare un modello LLM per la traduzione, è necessario usare una risorsa Foundry.
  

• Per informazioni su come creare e gestire una risorsa Foundry , vedereCreare la prima risorsa Foundry

Una risorsa di Traduttore di Azure è un'istanza del servizio creato. È possibile accedere a tutte le richieste API a Foundry Tools con un URL di endpoint e una chiave di sola lettura per l'autenticazione dell'accesso.

Prerequisiti

Per iniziare, è necessario un account Azure attivo.

Creare la risorsa di Traduttore di Azure

Con l'account Azure è possibile accedere a Translator tramite due tipi di risorse diversi:

• I tipi di risorse a servizio singolo consentono l'accesso a una chiave API e a un endpoint del servizio singoli.

• I tipi di risorse multiservizio consentono l'accesso a più strumenti Foundry usando una singola chiave API e un singolo endpoint.

Completare i dettagli del progetto e dell'istanza

Dopo aver deciso quale tipo di risorsa si vuole usare per accedere a Translator, è possibile immettere i dettagli per il progetto e l'istanza.

1. Sottoscrizione. Selezionare una delle sottoscrizioni di Azure disponibili.

2. Gruppo di risorse. È possibile creare un nuovo gruppo di risorse o aggiungere la risorsa a un gruppo di risorse preesistente che condivide ciclo di vita, autorizzazioni e criteri identici.

3. Area della risorsa. Scegliere Globale a meno che l'azienda o l'applicazione non richieda un'area specifica. Prima di selezionare un'area, vedere Supporto dell'area per Traduttore di Azure. Se si prevede di usare La traduzione documenti con autorizzazione di identità gestita, scegliere un'area geografica, ad esempio Stati Uniti orientali.

4. Nome. Immettere un nome per la risorsa. Il nome scelto deve essere univoco in Azure.

   Annotazioni

   Se si usa una funzionalità Traduttore che richiede l'endpoint di un dominio personalizzato, ad esempio Traduzione di documenti, l'input nel campo name è il parametro del nome di dominio personalizzato per l'endpoint.

Assicurarsi di immettere il valore corretto nel campo name per garantire il corretto funzionamento.

1. Piano tariffario. Selezionare un piano tariffario che soddisfi le proprie esigenze:

   • A ogni sottoscrizione è associato un piano gratuito.
   • Il piano gratuito offre le stesse caratteristiche e funzionalità dei piani a pagamento e non ha scadenza.
   • Per ogni sottoscrizione è disponibile una sola risorsa di livello gratuito.
   • Traduzione di documenti è supportata nei livelli a pagamento. Language Studio supporta solo i livelli di istanza S1 o D3. Per provare Traduzione di documenti, selezionare il livello di istanza Standard S1.

2. Se è stata creata una risorsa multiservizio, i collegamenti nella parte inferiore della scheda Informazioni di base forniscono documentazione tecnica relativa al funzionamento appropriato del servizio.

3. Selezionare Verifica e crea.

4. Esaminare le condizioni del servizio e selezionare Crea per distribuire la risorsa.

5. Dopo aver distribuito correttamente la risorsa, selezionare Vai alla risorsa.

Chiavi e URL dell'endpoint per l'autenticazione

Il metodo più rapido per autenticare le richieste dell'API Foundry Tools consiste nell'includere l'URL dell'endpoint e una chiave di sola lettura in un'intestazione di autenticazione. Per altre informazioni, vedereAutenticazione e autorizzazione

• Chiavi di autenticazione. La chiave è una stringa univoca passata a ogni richiesta al servizio di traduzione. È possibile passare la chiave tramite un parametro della stringa di query o specificandola nell'intestazione della richiesta HTTP.

• URL dell'endpoint. Usare l'endpoint globale nella richiesta API, a meno che non sia necessaria un'area di Azure o un endpoint personalizzato specifici. Per altre informazioni, vedere URL di base. L'URL dell'endpoint globale è api.cognitive.microsofttranslator.com.

Ottenere le chiavi e l'endpoint di autenticazione

Per autenticare la connessione alla risorsa Traduttore, sono necessari la chiave e l'endpoint della risorsa.

1. Dopo la distribuzione della nuova risorsa, selezionare Vai alla risorsa o passare alla pagina della risorsa.
2. Nel riquadro sinistro, in Gestione risorse, selezionare Chiavi ed endpoint.
3. Copiare e incollare le chiavi e l'URL dell'endpoint in una posizione comoda, ad esempio Blocco note.

Creare un client di Traduzione testo

Traduzione testo supporta sia gli endpoint globali che quelli regionali. Dopo avere ottenuto le chiavi di autenticazione, è necessario creare un'istanza di TextTranslationClientusando AzureKeyCredential per l'autenticazione, per interagire con il servizio Traduzione testo:

• Per creare TextTranslationClient usando un endpoint di risorse globale, è necessaria la risorsa chiave API:

    AzureKeyCredential credential = new('<apiKey>');
    TextTranslationClient client = new(credential);
  

• Per creare TextTranslationClient usando un endpoint di risorse a livello di area, è necessario che la risorsa chiave API e il nome dell'area in cui si trova la risorsa:

   AzureKeyCredential credential = new('<apiKey>');
   TextTranslationClient client = new(credential, '<region>');
  

Introduzione alle API REST di Traduttore di Azure

Questo argomento di avvio rapido illustra come usare Translator con le API REST.