Microsoft Foundry SDK a koncové body (klasické)

Aktuálně zobrazeno:Verze portálu Foundry (klasická) - Přechod na verzi nového portálu Foundry

Prostředek Foundry poskytuje jednotný přístup k modelům, agentům a nástrojům. Tento článek vysvětluje, jakou sadu SDK a koncový bod pro váš scénář použít.

Foundry SDK je dynamicky klientská sada SDK, která zveřejňuje všechna rozhraní API projektu Foundry prostřednictvím jednoho koncového bodu projektu. Sady SDK vyšší úrovně na ní vycházejí – například balíček Agent Framework foundry závisí na sadě Foundry SDK pro přístup k modelům, nástrojům a konfiguraci projektu Foundry.

sada SDK K čemu je to Koncový bod
Foundry SDK SDK pro tenkého klienta nad všemi API projektu Foundry Přístup k modelům Foundry a nástrojům platformy (vyhledávání souborů, interpret kódu, vyhledávání na webu, paměť, SharePoint, WorkIQ, Fabric IQ, MCP). https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Agent Framework Hostovaní agenti a systémy s více agenty se vytvářejí pomocí kódu. Balíček foundry závisí na sadě Foundry SDK pro přístup k projektu. Spusťte vlastní proces. Rozhraní API pro odpovědi v koncovém bodu projektu prostřednictvím FoundryChatClient.
OpenAI SDK Plný rozsah rozhraní OpenAI API, včetně embeddingů. Nejlepší latence a maximální kompatibilita OpenAI https://<resource-name>.openai.azure.com/openai/v1
Anthropic SDK Modely Claude od společnosti Anthropic nasazené ve Foundry. https://<resource-name>.services.ai.azure.com/anthropic
Sady SDK s nástroji Foundry Předem připravená řešení (Vision, Speech, Content Safety a další). Endpointy pro konkrétní nástroj.

Zvolte sadu SDK:

  • Použijte sadu Foundry SDK při vytváření aplikací s agenty, vyhodnoceními nebo funkcemi specifickými pro Foundry.
  • Použití rozhraní Agent Framework při sestavování hostovaných agentů nebo systémů s více agenty v kódu pomocí rozhraní API pro odpovědi
  • Použijte OpenAI SDK, když je vyžadována maximální kompatibilita s OpenAI nebo co nejnižší latence, při generování embeddingů nebo při použití přímých modelů Foundry prostřednictvím Chat Completions
  • Použití sady Anthropic SDK při práci s modely Anthropic Claude nasazenými v Foundry
  • Při práci s konkrétními službami AI (Vision, Speech, Language atd.) používejte sady SDK s nástroji Foundry Tools .

Poznámka

Typy prostředků: Prostředek Foundry poskytuje všechny dříve uvedené koncové body. Prostředek Azure OpenAI poskytuje pouze koncový bod /openai/v1.

Autentizace: Tyto ukázky používají Microsoft Entra ID (DefaultAzureCredential). Klíče rozhraní API fungují na /openai/v1. Předejte klíč jako api_key namísto tokenového poskytovatele.

Požadavky

  • Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si účet free Azure, který zahrnuje bezplatné zkušební předplatné.

  • Máte jednu z následujících Azure rolí RBAC pro vytváření a správu prostředků Foundry:

    • Foundry User (role s nejnižšími oprávněními pro vývoj)

      Důležité

      Nedávno byly přejmenovány role Foundry RBAC. Foundry User, Foundry Owner, Foundry Account Owner a Foundry Project Manager se dříve nazývaly Uživatel Azure AI, Vlastník Azure AI, Vlastník účtu Azure AI a Správce projektů Azure AI. Během zavádění přejmenování se stále můžou zobrazovat předchozí názvy na některých místech. ID rolí a základní oprávnění se při přejmenování nezmění.

    • Foundry Project Manager (pro správu projektů Foundry)

    • Přispěvatel nebo vlastník (pro oprávnění na úrovni předplatného)

    Podrobnosti o oprávněních jednotlivých rolí najdete v tématu Řízení přístupu na základě role pro Microsoft Foundry.

  • Nainstalujte jazykové moduly runtime, globální nástroje a rozšíření VS Code, jak je popsáno v části Příprava vývojového prostředí.

Důležité

Než začnete, ujistěte se, že je vaše vývojové prostředí připravené.
Tento článek se zaměřuje na kroky specifické pro konkrétní scénáře , jako je instalace sady SDK, ověřování a spouštění ukázkového kódu.

Ověření požadavků

Než budete pokračovat, potvrďte:

  • Azure předplatné je aktivní: az account show
  • Máte požadovanou roli RBAC: Kontrola Azure portálu → prostředku Foundry → řízení přístupu (IAM)
  • Nainstalovaný runtime jazyka:
    • Python: python --version (≥3.8)
  • Nainstalovaný runtime jazyka:
    • Node.js: node --version (≥18)
  • Nainstalovaný runtime jazyka:
    • .NET: dotnet --version (≥6.0)
  • Nainstalovaný runtime jazyka:
    • Java: java --version (≥11)

Foundry SDK

Sada Foundry SDK se připojí k jednomu koncovému bodu projektu, který poskytuje přístup k nejoblíbenějším funkcím Foundry:

https://<resource-name>.services.ai.azure.com/api/projects/<project-name>

Poznámka

Pokud vaše organizace používá vlastní subdoménu, nahraďte <resource-name> s <your-custom-subdomain> v adrese URL koncového bodu.

Tento přístup zjednodušuje konfiguraci aplikace. Místo správy více koncových bodů nakonfigurujete jeden.

Instalace sady SDK

Poznámka

Tento článek se týká projektu Foundry. Zde uvedený kód nefunguje pro projekt založený na centru. Další informace naleznete v tématu Typy projektů.

Poznámka

Verze sady SDK: Tento článek popisuje instalaci sady SDK 1.x. Ujistěte se, že ukázky, které sledujete, odpovídají nainstalovanému balíčku. Přejděte na novou dokumentaci k portálu Foundry a zobrazte si článek pro verzi 2.x.

Verze sady SDK Verze portálu Stav Balíček Python
2.x Slévárna (nové) Stabilní azure-ai-projects>=2.0.0
1.x Foundry (klasik) Stabilní azure-ai-projects==1.0.0

Klient projektů Azure AI pro Python je jednotná knihovna, která umožňuje společné používání více klientských knihoven připojením ke koncovému bodu jednoho projektu.

Spuštěním tohoto příkazu nainstalujte balíčky 1.x pro klasické projekty Foundry.

pip install openai azure-identity azure-ai-projects==1.0.0
Verze sady SDK Verze portálu Stav balíček Java
2.0.0 Slévárna (nové) Stabilní azure-ai-projects
azure-ai-agents
Verze sady SDK Verze portálu Stav Balíček JavaScriptu
2.0.1 Slévárna (nové) Stabilní @azure/ai-projects
1.0.1 Foundry Classic Stabilní @azure/ai-projects
Verze sady SDK Verze portálu Stav balíček .NET
2.0.0-beta.1 (náhled) Slévárna (nové) Náhled Azure.AI.Projects
Azure.AI.Projects.OpenAI
1.1.0 (GA) Foundry Classic Stabilní Azure.AI.Projects

Klientská knihovna Azure AI pro projekty v Javě je sjednocená knihovna, která umožňuje používat více klientských knihoven společně díky připojení k jednomu koncovému bodu projektu.

Důležité

Balíček Java azure-ai-projects nemá verzi GA 1.x. Ukázky kódu v částech Java používají přímo balíček azure-ai-inference, který je zastaralý a bude vyřazen 30. května 2026. V případě sady SDK pro projekty 2.x přejděte do nové dokumentace k portálu Foundry.

Přidejte tyto závislosti do Maven pom.xml pro klasické projekty Foundry.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-inference</artifactId>
    <version>1.0.0-beta.6</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.18.2</version>
</dependency>

Klientská knihovna Azure AI Projects pro JavaScript je sjednocená knihovna, která umožňuje používat více klientských knihoven dohromady připojením k jedinému koncovému bodu projektu.

Spuštěním tohoto příkazu nainstalujte balíčky JavaScriptu 1.x pro klasické projekty Foundry.

npm install @azure/ai-projects@1.0.1 @azure/identity

Klientská knihovna Azure AI Projects pro .NET je jednotná knihovna, která umožňuje propojení a současné používání více klientských knihoven tím, že se připojí k jedinému koncovému bodu projektu.

Spusťte tyto příkazy, abyste přidali balíčky Azure AI SDK verze 1.x pro projekty Foundry Classic.

# Add 1.x Azure AI SDK packages
dotnet add package Azure.Identity
dotnet add package Azure.AI.Projects --version 1.1.0
dotnet add package Azure.AI.Agents.Persistent --version 1.1.0
dotnet add package Azure.AI.Inference

Použití sady Foundry SDK

Sada SDK zveřejňuje dva typy klientů, protože Foundry a OpenAI mají různé tvary rozhraní API:

  • Project client – používá se pro operace nativní pro Foundry, kde OpenAI nemá žádný ekvivalent. Příklady: výpis připojení, načítání vlastností projektu a povolení trasování.
  • Klient kompatibilní s OpenAI – používá se pro funkce Foundry, které vycházejí z konceptů OpenAI. Rozhraní API pro odpovědi, agenty, vyhodnocení a vyladění používají všechny vzory požadavků a odpovědí ve stylu OpenAI. Tento klient také poskytuje přístup k přímým modelům Foundry (modely, které nejsou hostované v Azure-OpenAI, ale přímo ve Foundry). Koncový bod projektu obsluhuje tento provoz na /openai trase.

Většina aplikací používá oba klienty. Použijte klienta projektu k nastavení a konfiguraci a pak použijte klienta kompatibilního s OpenAI pro spouštění agentů, hodnocení a volání modelů (včetně přímých modelů Foundry).

Vytvoření klienta projektu:

from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

project_client = AIProjectClient(
    endpoint="https://<resource-name>.services.ai.azure.com/api/projects/<project-name>",
    credential=DefaultAzureCredential(),
)

Vytvořte klienta kompatibilního s OpenAI z projektu:

models = project_client.get_openai_client(api_version="2024-10-21")
chat_responses = models.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "What is the size of France in square miles?"},
    ],
)

print(chat_responses.choices[0].message.content)

Vytvoření klienta projektu:

package com.azure.ai.foundry.samples;

import com.azure.ai.inference.ChatCompletionsClient;
import com.azure.ai.inference.ChatCompletionsClientBuilder;
import com.azure.ai.inference.models.ChatCompletions;
import com.azure.core.credential.AzureKeyCredential;
import com.azure.core.credential.TokenCredential;
import com.azure.core.exception.HttpResponseException;
import com.azure.core.util.logging.ClientLogger;
import com.azure.identity.DefaultAzureCredentialBuilder;

String  prompt = "What best practices should I follow when asking an AI model to review Java code?";
String endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
TokenCredential credential = new DefaultAzureCredentialBuilder().build();
ChatCompletionsClient client = new ChatCompletionsClientBuilder()
    .credential(credential)
    .endpoint(endpoint)
    .buildClient();
```**Create and use an OpenAI-compatible client from your project:**
```java
ChatCompletions completions = client.complete(prompt);
String content = completions.getChoice().getMessage().getContent();
System.out.println("\nResponse from AI assistant:\n" + content);

Vytvoření klienta projektu:

const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const deployment = "gpt-4o";

const project = new AIProjectClient(endpoint, new DefaultAzureCredential());

Vytvořte klienta kompatibilního s OpenAI z projektu:

const client = await project.getAzureOpenAIClient({
    // The API version should match the version of the Azure OpenAI resource
    apiVersion: "2024-12-01-preview"
});
const chatCompletion = await client.chat.completions.create({
    model: deployment,
    messages: [
        { role: "system", content: "You are a helpful assistant" },
        { role: "user", content: "What is the speed of light?" },
    ],
});

console.log(chatCompletion.choices[0].message.content);

Vytvoření klienta projektu:

using System.ClientModel.Primitives;
using Azure.AI.OpenAI;
using Azure.AI.Projects;
using Azure.Identity;
using OpenAI.Chat;

string endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
AIProjectClient projectClient = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential());

Vytvořte klienta kompatibilního s OpenAI z projektu:

ClientConnection connection = projectClient.GetConnection(typeof(AzureOpenAIClient).FullName!);
if (!connection.TryGetLocatorAsUri(out Uri uri) || uri is null)
{
    throw new InvalidOperationException("Invalid URI.");
}
uri = new Uri($"https://{uri.Host}");
const string modelDeploymentName = "gpt-4o";  
AzureOpenAIClient azureOpenAIClient = new AzureOpenAIClient(uri, new DefaultAzureCredential());
ChatClient chatClient = azureOpenAIClient.GetChatClient(deploymentName: modelDeploymentName);

Console.WriteLine("Complete a chat");
ChatCompletion result = chatClient.CompleteChat("List all the rainbow colors");
Console.WriteLine(result.Content[0].Text);

Co můžete dělat se sadou Foundry SDK

Řešení potíží

Chyby ověřování

Pokud se zobrazí DefaultAzureCredential failed to retrieve a token:

  1. Verify Azure CLI se ověřuje:

    az account show
    az login  # if not logged in
    
  2. Zkontrolovat přiřazení role RBAC:

    • Ověřte, že v projektu Foundry máte alespoň roli uživatele Foundry.

      Důležité

      Nedávno byly přejmenovány role Foundry RBAC. Foundry User, Foundry Owner, Foundry Account Owner a Foundry Project Manager se dříve nazývaly Uživatel Azure AI, Vlastník Azure AI, Vlastník účtu Azure AI a Správce projektů Azure AI. Během zavádění přejmenování se stále můžou zobrazovat předchozí názvy na některých místech. ID rolí a základní oprávnění se při přejmenování nezmění.

    • Viz Přiřazení rolí Azure

  3. Pro spravovanou identitu v produkčním prostředí:

Chyby konfigurace koncového bodu

Pokud se zobrazí Connection refused nebo 404 Not Found:

  • Ověřte, že názvy zdrojů a projektů odpovídají vašemu skutečnému nasazení.
  • Kontrola formátu adresy URL koncového bodu: Mělo by být https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
  • Pro vlastní subdomény: Nahraďte <resource-name> vlastní subdoménou.

Neshody verzí sady SDK

Pokud ukázky kódu selžou s AttributeError nebo ModuleNotFoundError:

  • Kontrola verze sady SDK:

    pip show azure-ai-projects  # Python
    npm list @azure/ai-projects  # JavaScript
    dotnet list package  # .NET
    
  • Přeinstalace se správnými příznaky verze: Viz instalační příkazy v příslušných jazykových sekcích výše

OpenAI SDK

Sadu OpenAI SDK použijte, pokud chcete mít úplnou plochu rozhraní OpenAI API a maximální kompatibilitu klientů. Tento koncový bod poskytuje přístup k Azure modelům OpenAI a přímým modelům Foundry (prostřednictvím rozhraní API pro dokončování chatu). Neposkytuje přístup k funkcím specifickým pro Foundry, jako jsou agenti a hodnocení.

Následující fragment kódu ukazuje, jak přímo použít koncový bod Azure OpenAI /openai/v1.

from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

client = OpenAI(  
  base_url = "https://<resource-name>.openai.azure.com/openai/v1/",  
  api_key=token_provider,
)

response = client.responses.create(
    model="model_deployment_name",
    input= "What is the size of France in square miles?" 
)

print(response.model_dump_json(indent=2)) 

Další informace najdete v tématu podporované programovací jazyky Azure OpenAI. Očekávaný výstup:

{
  "id": "resp_abc123",
  "object": "response",
  "created": 1234567890,
  "model": "gpt-5.2",
  "output_text": "France has an area of approximately 213,011 square miles (551,695 square kilometers)."
}

Další informace najdete v tématu programovací jazyky podporované Azure OpenAI

Důležité

Položky označené (Preview) v tomto článku jsou aktuálně ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce nemusí být podporované nebo můžou mít omezené možnosti. Další informace najdete v tématu Supplementální podmínky použití pro Microsoft Azure Verze Preview.

Následující fragment kódu ukazuje, jak přímo použít koncový bod Azure OpenAI /openai/v1.

import com.azure.ai.openai.OpenAIClient;
import com.azure.ai.openai.OpenAIClientBuilder;
import com.azure.ai.openai.models.ChatChoice;
import com.azure.ai.openai.models.ChatCompletions;
import com.azure.ai.openai.models.ChatCompletionsOptions;
import com.azure.ai.openai.models.ChatRequestAssistantMessage;
import com.azure.ai.openai.models.ChatRequestMessage;
import com.azure.ai.openai.models.ChatRequestSystemMessage;
import com.azure.ai.openai.models.ChatRequestUserMessage;
import com.azure.ai.openai.models.ChatResponseMessage;
import com.azure.core.credential.AzureKeyCredential;
import com.azure.core.util.Configuration;

import java.util.ArrayList;
import java.util.List;

String endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
String deploymentName = "gpt-5.2";
TokenCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
OpenAIClient client = new OpenAIClientBuilder()
    .credential(defaultCredential)
    .endpoint("{endpoint}")
    .buildClient();

List<ChatRequestMessage> chatMessages = new ArrayList<>();
chatMessages.add(new ChatRequestSystemMessage("You are a helpful assistant."));
chatMessages.add(new ChatRequestUserMessage("What is the speed of light?"));

ChatCompletions chatCompletions = client.getChatCompletions(deploymentName, new ChatCompletionsOptions(chatMessages));

System.out.printf("Model ID=%s is created at %s.%n", chatCompletions.getId(), chatCompletions.getCreatedAt());
for (ChatChoice choice : chatCompletions.getChoices()) {
    ChatResponseMessage message = choice.getMessage();
    System.out.printf("Index: %d, Chat Role: %s.%n", choice.getIndex(), message.getRole());
    System.out.println("Message:");
    System.out.println(message.getContent());

Další informace o používání sady OpenAI SDK najdete v tématu Azure podporované programovací jazyky OpenAI.

import { AzureOpenAI } from "openai";
import { DefaultAzureCredential, getBearerTokenProvider } from "@azure/identity";

const deployment = "gpt-4o";
const endpoint = "https://<resource-name>.openai.azure.com";
const scope = "https://ai.azure.com/.default";
const apiVersion = "2024-04-01-preview";

const azureADTokenProvider = getBearerTokenProvider(new DefaultAzureCredential(), scope);

const options = { azureADTokenProvider, deployment, apiVersion, endpoint };

const client = new AzureOpenAI(options);

const result = await client.chat.completions.create({
    model: deployment,
    messages: [
        { role: "system", content: "You are a helpful assistant" },
        { role: "user", content: "What is the speed of light?" },
    ],
});
console.log(result.choices[0].message.content);

Další informace o používání sady OpenAI SDK najdete v tématu Azure podporované programovací jazyky OpenAI.

  1. Nainstalujte balíček OpenAI: Spuštěním tohoto příkazu přidejte klientskou knihovnu OpenAI do projektu .NET.
    dotnet add package OpenAI
    ```When it succeeds, the .NET CLI confirms that it installed the `OpenAI` package.
    
    This snippet configures `DefaultAzureCredential`, builds `OpenAIClientOptions`, and creates a `ChatClient` for the Azure OpenAI v1 endpoint.
    ```csharp
    using System.ClientModel.Primitives;
    using Azure.Identity;
    using OpenAI;
    using OpenAI.Chat;
    
    #pragma warning disable OPENAI001
    
    const string directModelEndpoint  = "https://<resource-name>.openai.azure.com/openai/v1/";
    const string modelDeploymentName = "gpt-5.2";    
    
    BearerTokenPolicy tokenPolicy = new(
         new DefaultAzureCredential(),
         "https://ai.azure.com/.default");
    OpenAIClient openAIClient = new(
         authenticationPolicy: tokenPolicy,
         options: new OpenAIClientOptions()
         {
             Endpoint = new($"{directModelEndpoint}"),
         });
    ChatClient chatClient = openAIClient.GetChatClient(modelDeploymentName);
    
    ChatCompletion completion = await chatClient.CompleteChatAsync(
         [
             new SystemChatMessage("You are a helpful assistant."),
                         new UserChatMessage("How many feet are in a mile?")
         ]);
    
    Console.WriteLine(completion.Content[0].Text);
    #pragma warning restore OPENAI001
    

Další informace o používání sady OpenAI SDK najdete v tématu Azure podporované programovací jazyky OpenAI.

Agentní rámec

Microsoft Agent Framework je opensourcová sada SDK (Python a .NET) pro vytváření agentů a systémů s více agenty v kódu. Jedná se o doporučenou cestu pro hostované agenty v Microsoft Foundry.

Spusťte svůj kód na hostovaném agentovi

Hlavní možností pro agenty založené na kódu ve Foundry jsou Hostovaní agenti. Napište agenta pomocí Agent Frameworku, zabalte ho jako bitovou kopii kontejneru nebo soubor ZIP se zdrojovým kódem a nechte ho ve Foundry běžet se spravovaným endpointem, automatickým škálováním na izolovaných Micro VMs, vyhrazenou identitou agenta Microsoft Entra, stavem na úrovni relací a komplexní observabilitou end-to-end.

Hostovaní agenti jsou doporučenou volbou, pokud chcete koncový bod spravovaný platformou Foundry a síťově adresovatelný, který mohou volat jiné aplikace nebo agenti. Viz Nasazení prvního hostovaného agenta.

Sestavení agentů v kódu mimo Foundry pomocí rozhraní API odpovědí

Pokud hostujete svého agenta mimo Foundry – ve vlastním procesu nebo infrastruktuře – můžete rozhraní Agent Framework použít také k přímému volání rozhraní API odpovědí v koncovém bodu projektu . Agent Framework se připojuje prostřednictvím FoundryChatClient poskytovatele, který cílí na:

{project_endpoint}/openai/v1/responses

Přechod přes koncový bod projektu – místo koncového bodu OpenAI na úrovni prostředku – poskytne vašemu agentovi:

  • Modely Foundry z katalogu (Azure OpenAI a přímé modely Foundry) prostřednictvím jediného rozhraní API.
  • Nástroje platformy nad rámec sady nástrojů OpenAI, včetně vyhledávání souborů, interpretu kódu, paměti, webového vyhledávání, serverů MCP, SharePoint, WorkIQ a Fabric IQ.
  • Data v rámci projektu, ověřování nástroje On-Behalf-Of (OBO) a trasování projektu, filtry obsahu a konfigurace identity.

Tento vzor doplňuje hostované agenty, není jejich alternativou – stejný kód v Agent Frameworku může už dnes z vašeho vlastního procesu volat API Responses a později ho můžete zabalit jako hostovaného agenta, až budete chtít koncový bod spravovaný službou Foundry. Viz Rychlý start: Sestavení agentů pomocí rozhraní API pro odpovědi.

Úplné porovnání typů agentů a možností hostování najdete v tématu Co je Microsoft Foundry Agent Service?.

SDK nástroje Foundry

Foundry Tools (dříve Azure AI Services) jsou hotová specializovaná řešení s vyhrazenými sadami SDK. Pomocí následujících koncových bodů můžete pracovat s nástroji Foundry.

Jaký koncový bod byste měli použít?

Vyberte koncový bod podle vašich potřeb:

Pomocí koncového bodu služby Azure AI Services můžete přistupovat k nástrojům pro Počítačové zpracování obrazu, zabezpečení obsahu, analýzu dokumentů, jazyka, překladu a nástroje slévárství tokenů.

Koncový bod Foundry Tools: https://<your-resource-name>.cognitiveservices.azure.com/

Poznámka

Koncové body používají buď název vašeho prostředku, nebo vlastní subdoménu. Pokud vaše organizace nastavila vlastní subdoménu, nahraďte ji your-resource-name za your-custom-subdomain ve všech příkladech koncových bodů.

Pokud vaše úlohy používají vyřazované funkce Azure AI Jazyk – například analýzu mínění, extrakci klíčových frází, shrnutí, propojení entit, CLU nebo CQA – plánujte migraci na alternativám Microsoft Foundry. Pro nový vývoj zvažte použití sady Foundry SDK nebo koncového bodu kompatibilního s OpenAI, jak je popsáno výše v tomto článku. Viz Migrate from Language Studio to Microsoft Foundry.

Pro nástroje Speech a Translation Foundry použijte koncové body v následujících tabulkách. Zástupné symboly nahraďte informacemi o prostředcích.

Koncové body řeči

Nástroj Foundry Koncový bod
Převod řeči na text (standardní) https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com
Převod textu na řeč (Neurální sítě) https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com
Vlastní hlas https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/

Koncové body překladu

Nástroj Foundry Koncový bod
Překlad textu https://api.cognitive.microsofttranslator.com/
Překlad dokumentu https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/

Koncové body jazyka

Nástroj Foundry Koncový bod
Analýza textu https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com

Důležité

Dne 20. března 2027 bude Azure Language Studio vyřazen a migrován na Microsoft Foundry. Všechny možnosti a budoucí vylepšení budou k dispozici v Microsoft Foundry.

31. března 2029 budou následující možnosti jazyka Azure vyřazeny (ukončení podpory). Před tímto datem by uživatelé měli migrovat stávající úlohy a nasadit nové projekty do modelů Microsoft Foundry pro lepší porozumění přirozenému jazyku a zjednodušenou integraci aplikací:

  • Extrakce klíčových frází
  • Analýza mínění a dolování názorů
  • Vlastní klasifikace textu
  • Konverzační porozumění jazyka (CLU)
  • Přizpůsobené odpovídání na otázky (CQA)
  • Pracovní postup orchestrace
  • Shrnutí (extraktivní a abstraktní pro dokumenty a konverzace)
  • Propojení entit

Základní funkce s nepřetržitou podporou: Rozpoznávání jazyka, detekce PII, Analýza textu pro zdraví, předpřipravený NER a vlastní NER.

Možnosti migrace najdete v tématu Migrace ze sady Language Studio do Microsoft Foundry.

Podporované nástroje Foundry v jazyce C#

Nástroj Foundry Popis Rychlá zprovoznění a referenční dokumentace
Ikona řeči Řeč Přidejte do aplikací převod řeči na text, textu na řeč, překlad a rozpoznávání mluvčího. Rychlý start pro převod řeči na text

Rychlý start pro převod textu na řeč

Rychlý start pro překlad řeči

Speech SDK pro .NET

• balíček NuGet Speech (Speech CLI)
Jazyková ikona Jazyk Vytvářejte aplikace s možnostmi porozumění přirozenému jazyku. Podporované funkce: Rozpoznávání jazyka, detekce PII, Analýza textu pro zdraví, předpřipravený NER a vlastní NER. Vyřazení z provozu 31. března 2029: Analýza mínění a dolování názorů, extrakce klíčových frází, shrnutí, propojení entit, CQA a CLU. Rychlý start pro odpovědi na vlastní otázky (CQA) (vyřazení z provozu 31. března 2029)

Rychlý start propojení entit(ukončení 31. března 2029)

Rychlý start pro rozpoznávání jazyka

Rychlý start pro extrakci klíčových frází(vyřazení z provozu 31. března 2029)

Rychlý úvod do detekce pojmenovaných entit (NER)

Rychlý průvodce detekcí osobně identifikovatelných údajů (PII)

Analýza mínění a dolování názorů rychlý start(vyřazení z provozu 31. března 2029)

Rychlý start pro shrnutí textu, dokumentu a konverzace(vyřazení z provozu 31. března 2029)

Použití Analýza textu pro rychlý start ve zdravotnictví

Language SDK pro .NET (analýza textu)

Language NuGet balíček (analýza textu)

Language SDK pro .NET (odpověď na otázky)

Language NuGet balíček (odpovídání na otázky)

Přejděte ze sady Language Studio do Microsoft Foundry pro pokyny k migraci úloh, jejichž funkce jsou ve vyřazovacím procesu
Ikona překladače Překladač Pomocí technologie překladu založené na umělé inteligenci můžete překládat více než 100 používaných jazyků a dialektů s riziky a ohrožených jazyků. Translator SDK pro .NET (text)

• balíček NuGet Translator (text)

Translator SDK pro .NET (batch)

• balíček NuGet Translator (batch)
Ikona Azure AI VyhledávačAzure AI Vyhledávač Přineste AI poháněné cloudové vyhledávání do svých mobilních a webových aplikací. Použití agentic retrieval quickstart

Rychlé zprovoznění vektorového vyhledávání

Rychlý start klasického generativního vyhledávání (RAG) se zakotvením dat

Rychlé zprovoznění fulltextového vyhledávání

Rychlý start pro sémantické hodnocení

Chat s modely Azure OpenAI pomocí vlastních dat - rychlý úvod

Azure AI Vyhledávač SDK pro .NET

• balíček Azure AI Vyhledávač NuGet
Ikona Zabezpečení obsahu Detekce škodlivého obsahu v aplikacích a službách Rychlý start k analýze textového obsahu

Rychlé zprovoznění seznamu blokovaných textů

Rychlý start analýzy obsahu obrázků

Kontent Safety SDK pro .NET

Balíček NuGet pro bezpečnost obsahu
Ikona Document Intelligence Document Intelligence Převést dokumenty na inteligentní řešení založená na datech. Rychlý start k funkci Document Intelligence

Document Intelligence SDK pro .NET

• balíček NuGet Document Intelligence
Ikona Vision Vision Analyzujte obsah v digitálních obrázcích a multimediálních prostředcích. Azure Vision ve Foundry Tools v3.2 GA Přečtěte si rychlý začátek

Rychlý start k analýze obrázků

Rychlé zprovoznění služby Rozpoznávání tváře

Vision SDK pro .NET

• balíček NuGet Vision

Nástroje Foundry podporované Javou

Nástroj Foundry Popis Rychlá zprovoznění a referenční dokumentace
Ikona řeči Řeč Přidejte do aplikací převod řeči na text, textu na řeč, překlad a rozpoznávání mluvčího. Rychlý start pro převod řeči na text

Rychlý start pro převod textu na řeč

Rychlý start pro překlad řeči

Speech SDK pro Java

Balíček Speech Maven
Jazyková ikona Jazyk Vytvářejte aplikace s možnostmi porozumění přirozenému jazyku. Podporované funkce: Rozpoznávání jazyka, detekce PII, Analýza textu pro zdraví, předpřipravený NER a vlastní NER. Vyřazení z provozu 31. března 2029: Analýza mínění a dolování názorů, extrakce klíčových frází, shrnutí, propojení entit, CQA a CLU. Rychlý start propojení entit(ukončení 31. března 2029)

Rychlý start pro rozpoznávání jazyka

Rychlý start pro extrakci klíčových frází(vyřazení z provozu 31. března 2029)

Rychlý úvod do detekce pojmenovaných entit (NER)

Rychlý průvodce detekcí osobně identifikovatelných údajů (PII)

Analýza mínění a dolování názorů rychlý start(vyřazení z provozu 31. března 2029)

Rychlý start pro shrnutí textu, dokumentu a konverzace(vyřazení z provozu 31. března 2029)

Použití Analýza textu pro rychlý start ve zdravotnictví

Language SDK pro Java (analýza textu)

Balíček Language Maven

Přejděte ze sady Language Studio do Microsoft Foundry pro pokyny k migraci úloh, jejichž funkce jsou ve vyřazovacím procesu
Ikona překladače Překladač Pomocí technologie překladu založené na umělé inteligenci můžete překládat více než 100 používaných jazyků a dialektů s riziky a ohrožených jazyků. Translator SDK pro Java (text)

Balíček Translator Maven (text)
Ikona Azure AI VyhledávačAzure AI Vyhledávač Přineste AI poháněné cloudové vyhledávání do svých mobilních a webových aplikací. Použití agentic retrieval quickstart

Rychlé zprovoznění vektorového vyhledávání

Rychlý start klasického generativního vyhledávání (RAG) se zakotvením dat

Rychlé zprovoznění fulltextového vyhledávání

Rychlý start pro sémantické hodnocení

Chat s modely Azure OpenAI pomocí vlastních dat - rychlý úvod

Azure AI Vyhledávač SDK pro Java

Azure AI Vyhledávač Maven balíček
Ikona Zabezpečení obsahu Detekce škodlivého obsahu v aplikacích a službách Rychlý start k analýze textového obsahu

Rychlé zprovoznění seznamu blokovaných textů

Rychlý start analýzy obsahu obrázků

Content Safety SDK pro Java

Balíček Content Safety Maven
Ikona Document Intelligence Document Intelligence Převést dokumenty na inteligentní řešení založená na datech. Rychlý start k funkci Document Intelligence

Document Intelligence SDK pro Java

Balíček Document Intelligence Maven
Ikona Vision Vision Analyzujte obsah v digitálních obrázcích a multimediálních prostředcích. Rychlý start k analýze obrázků

Rychlé zprovoznění služby Rozpoznávání tváře

Vision SDK pro Java

Balíček Vision Maven

Podporované nástroje Foundry v JavaScriptu

Nástroj Foundry Popis Rychlá zprovoznění a referenční dokumentace
Ikona řeči Řeč Přidejte do aplikací převod řeči na text, textu na řeč, překlad a rozpoznávání mluvčího. Rychlý start pro převod řeči na text

Rychlý start pro převod textu na řeč

Rychlý start pro překlad řeči

Speech SDK pro JavaScript

Balíček Npm služby Speech
Jazyková ikona Jazyk Vytvářejte aplikace s možnostmi porozumění přirozenému jazyku. Podporované funkce: Rozpoznávání jazyka, detekce PII, Analýza textu pro zdraví, předpřipravený NER a vlastní NER. Vyřazení z provozu 31. března 2029: Analýza mínění a dolování názorů, extrakce klíčových frází, shrnutí, propojení entit, CQA a CLU. Rychlý start propojení entit(ukončení 31. března 2029)

Rychlý start pro rozpoznávání jazyka

Rychlý start pro extrakci klíčových frází(vyřazení z provozu 31. března 2029)

Rychlý úvod do detekce pojmenovaných entit (NER)

Rychlý průvodce detekcí osobně identifikovatelných údajů (PII)

Analýza mínění a dolování názorů rychlý start(vyřazení z provozu 31. března 2029)

Rychlý start pro shrnutí textu, dokumentu a konverzace(vyřazení z provozu 31. března 2029)

Použití Analýza textu pro rychlý start ve zdravotnictví

Language SDK pro JavaScript (analýza textu)

Balíček npm jazyka

Přejděte ze sady Language Studio do Microsoft Foundry pro pokyny k migraci úloh, jejichž funkce jsou ve vyřazovacím procesu
Ikona překladače Překladač Pomocí technologie překladu založené na umělé inteligenci můžete překládat více než 100 používaných jazyků a dialektů s riziky a ohrožených jazyků. Translator SDK pro JavaScript (text)

Balíček npm Translator (text)
Ikona Azure AI VyhledávačAzure AI Vyhledávač Přineste AI poháněné cloudové vyhledávání do svých mobilních a webových aplikací. Použití agentic retrieval quickstart

Rychlé zprovoznění vektorového vyhledávání

Rychlý start klasického generativního vyhledávání (RAG) se zakotvením dat

Rychlé zprovoznění fulltextového vyhledávání

Rychlý start pro sémantické hodnocení

Chat s modely Azure OpenAI pomocí vlastních dat - rychlý úvod

Azure AI Vyhledávač SDK pro JavaScript

Azure AI Vyhledávač npm balíček
Ikona Zabezpečení obsahu Detekce škodlivého obsahu v aplikacích a službách Rychlý start k analýze textového obsahu

Rychlé zprovoznění seznamu blokovaných textů

Rychlý start analýzy obsahu obrázků

Balíček NPM pro bezpečnost obsahu
Ikona Document Intelligence Document Intelligence Převést dokumenty na inteligentní řešení založená na datech. Rychlý start k funkci Document Intelligence

Document Intelligence SDK pro JavaScript

balíček Document Intelligence NPM
Ikona Vision Vision Analyzujte obsah v digitálních obrázcích a multimediálních prostředcích. Azure Vision ve Foundry Tools v3.2 GA Přečtěte si rychlý začátek

Rychlý start k analýze obrázků

Rychlé zprovoznění služby Rozpoznávání tváře

Vision SDK pro JavaScript

Balíček npm vision

Nástroje Foundry podporované Pythonem

Nástroj Foundry Popis Rychlá zprovoznění a referenční dokumentace
Ikona řeči Řeč Přidejte do aplikací převod řeči na text, textu na řeč, překlad a rozpoznávání mluvčího. Rychlý start pro převod řeči na text

Rychlý start pro převod textu na řeč

Rychlý start pro překlad řeči

Speech SDK pro Python

Balíček Speech PyPi
Jazyková ikona Jazyk Vytvářejte aplikace s možnostmi porozumění přirozenému jazyku. Podporované funkce: Rozpoznávání jazyka, detekce PII, Analýza textu pro zdraví, předpřipravený NER a vlastní NER. Vyřazení z provozu 31. března 2029: Analýza mínění a dolování názorů, extrakce klíčových frází, shrnutí, propojení entit, CQA a CLU. Rychlý start pro odpovědi na vlastní otázky (CQA) (vyřazení z provozu 31. března 2029)

Rychlý start propojení entit(ukončení 31. března 2029)

Rychlý start pro rozpoznávání jazyka

Rychlý start pro extrakci klíčových frází(vyřazení z provozu 31. března 2029)

Rychlý start k detekci pojmenovaných entit (NER)

Rychlý průvodce detekcí osobně identifikovatelných údajů (PII)

Analýza mínění a dolování názorů rychlý start(vyřazení z provozu 31. března 2029)

Rychlý start pro shrnutí textu, dokumentu a konverzace(vyřazení z provozu 31. března 2029)

Použití Analýza textu pro rychlý start ve zdravotnictví

Language SDK pro Python (analýza textu)

Balíček PyPi jazyka (analýza textu)

Language SDK pro Python (odpovědi na otázky)

Balíček PyPi jazyka (odpověď na otázky)

Language SDK pro Python (jazykové konverzace)(vyřazení 31. března 2029)

Balíček PyPi jazyka (jazykové konverzace)(vyřazení z 31. března 2029)

Přejděte ze sady Language Studio do Microsoft Foundry pro pokyny k migraci úloh, jejichž funkce jsou ve vyřazovacím procesu
Ikona překladače Překladač Pomocí technologie překladu založené na umělé inteligenci můžete překládat více než 100 používaných jazyků a dialektů s riziky a ohrožených jazyků. Translator SDK pro Python (text)

Balíček Translator PyPi (text)

Translator SDK pro Python (batch)

Balíček Translator PyPi (batch)
Ikona Azure AI VyhledávačAzure AI Vyhledávač Přineste AI poháněné cloudové vyhledávání do svých mobilních a webových aplikací. Rychlý start pro připojení k vyhledávací službě

Použití agentic retrieval quickstart

Rychlé zprovoznění vektorového vyhledávání

Rychlý start klasického generativního vyhledávání (RAG) se zakotvením dat

Rychlé zprovoznění fulltextového vyhledávání

Rychlý start pro sémantické hodnocení

Chat s modely Azure OpenAI pomocí vlastních dat - rychlý úvod

Azure AI Vyhledávač SDK pro Python

balíček Azure AI Vyhledávač PyPi
Ikona Zabezpečení obsahu Detekce škodlivého obsahu v aplikacích a službách Rychlý start k analýze textového obsahu

Rychlé zprovoznění seznamu blokovaných textů

Rychlý start analýzy obsahu obrázků

Kontent Safety SDK pro Python

Balíček PyPi bezpečnosti obsahu
Ikona Document Intelligence Document Intelligence Převést dokumenty na inteligentní řešení založená na datech. Rychlý start k funkci Document Intelligence

Document Intelligence SDK pro Python

Balíček PyPi Document Intelligence
Ikona Vision Vision Analyzujte obsah v digitálních obrázcích a multimediálních prostředcích. Azure Vision ve Foundry Tools v3.2 GA Přečtěte si rychlý začátek

Rychlý start k analýze obrázků

Rychlé zprovoznění služby Rozpoznávání tváře

Vision SDK pro Python

Balíček Vision PyPi