Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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.
| sada SDK | K čemu to je | Endpoint |
|---|---|---|
| Foundry SDK | Funkce specifické pro Foundry s rozhraními kompatibilními s OpenAI Zahrnuje přístup k přímým modelům Foundry prostřednictvím rozhraní API pro odpovědi (nikoli dokončování chatu). | https://<resource-name>.services.ai.azure.com/api/projects/<project-name> |
| OpenAI SDK | Nejnovější modely a funkce sady OpenAI SDK s úplným povrchem rozhraní OpenAI API Modely Foundry jsou dostupné prostřednictvím rozhraní API pro dokončování chatu (ne odpovědi). | https://<resource-name>.openai.azure.com/openai/v1 |
| Nástroje Foundry SDK | Předem připravená řešení (Vision, Speech, Content Safety a další). | Koncové body specifické pro konkrétní nástroje (se liší podle služby). |
| Agent Framework | Orchestrace více agentů v kódu Nezávislý na cloudových službách. | Používá koncový bod projektu prostřednictvím sady Foundry SDK. |
Zvolte sadu SDK:
- Použijte Foundry SDK při vytváření aplikací s agenty, hodnoceními nebo funkcemi specifickými pro Foundry.
- Použijte sadu OpenAI SDK, pokud je vyžadována maximální kompatibilita s OpenAI, nebo pokud používáte přímé modely Foundry pomocí dokončování chatu.
- Při práci s konkrétními službami AI (Vision, Speech, Language atd.) používejte sady SDK s nástroji Foundry Tools .
- Použití agenta Framework při sestavování systémů s více agenty v kódu (místní orchestrace)
Poznámka:
Typy prostředků: Prostředek Foundry poskytuje všechny dříve uvedené koncové body. Prostředek Azure OpenAI poskytuje pouze /openai/v1 koncový bod.
Ověřování: Ukázky zde používají Microsoft Entra ID (DefaultAzureCredential). Klíče API fungují na /openai/v1. Klíč předejte jako api_key namísto zprostředkovatele tokenu.
Předpoklady
-
Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si bezplatný účet Azure, který zahrnuje bezplatné zkušební předplatné.
Máte jednu z následujících rolí Azure RBAC pro vytváření a správu prostředků Foundry:
- Uživatel Azure AI (role s nejnižšími oprávněními pro vývoj)
- Azure AI 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 požadované jazykové moduly runtime, globální nástroje a rozšíření pro Visual Studio 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:
- Předplatné Azure je aktivní:
az account show - Máte požadovanou roli RBAC: Zkontrolujte portál Azure → prostředek Foundry → řízení přístupu (IAM)
- Nainstalované prostředí pro běh jazyka:
- Python:
python --version(≥3.8) - Node.js:
node --version(≥18) - .NET:
dotnet --version(≥6.0) - Java:
java --version(≥11)
- Python:
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><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.
Nainstalujte SDK
| Verze sady SDK | Verze portálu | Stav | Balíček Pythonu |
|---|---|---|---|
| 2.x | Slévárna (nové) | Stabilní | azure-ai-projects>=2.0.0 |
| 1.x | Slévárna (klasický) | Stabilní | azure-ai-projects==1.0.0 |
Klientská knihovna Azure AI Projects pro Python je jednotná knihovna, která umožňuje společně používat více klientských knihoven připojením k jednomu koncovému bodu projektu.
Spuštěním tohoto příkazu nainstalujte balíčky pro projekty Foundry.
pip install azure-ai-projects >=2.0.0
::: konec-zóny
| Verze sady SDK | Verze portálu | Stav | Balíček Java |
|---|---|---|---|
| 1.0.0-beta.3 1.0.0-beta.1 |
Slévárna (nové) | Náhled | azure-ai-projectsazure-ai-agents |
| Verze sady SDK | Verze portálu | Stav | Balíček JavaScriptu |
|---|---|---|---|
| 2.0.0-beta.4 (náhled) | Slévárna (nové) | Náhled | @azure/ai-projects 'prerelease' |
| 1.0.1 | Foundry Classic | Stabilní | @azure/ai-projects |
| Verze sady SDK | Verze portálu | Stav | Balíček .NET |
|---|---|---|---|
| 1.2.0-beta.5 (náhled) | Slévárna (nové) | Náhled | Azure.AI.ProjectsAzure.AI.Projects.Openai |
| 1.x (GA) | Foundry Classic | Stabilní | Azure.AI.Projects |
Klientská knihovna Azure AI Projects pro Javu (Preview) je jednotná knihovna, která umožňuje používat více klientských knihoven společně připojením k jednomu koncovému bodu projektu.
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 se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.
Přidejte tyto balíčky do instalace pro projekty Foundry.
package com.azure.ai.agents;
import com.azure.core.util.Configuration;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.openai.models.responses.Response;
import com.openai.models.responses.ResponseCreateParams;
Klientská knihovna Azure AI Projects pro JavaScript je jednotná knihovna, která umožňuje používat více klientských knihoven společně připojením k jednomu koncovému bodu projektu.
Spuštěním tohoto příkazu nainstalujte ukázkové balíčky JavaScriptu pro projekty Foundry.
npm install @azure/ai-projects@beta @azure/identity dotenv
Klientská knihovna Azure AI Projects pro .NET je jednotná knihovna, která umožňuje používat více klientských knihoven společně připojením k jednomu koncovému bodu projektu.
Spuštěním tohoto příkazu přidejte do projektu .NET balíček Azure.AI.Projects.
dotnet add package Azure.AI.Projects --prerelease
dotnet add package Azure.AI.Projects.OpenAI --prerelease
dotnet add package Azure.Identity
Použití sady Foundry SDK
Sada SDK zveřejňuje dva typy klientů, protože Foundry a OpenAI mají různé tvary rozhraní API:
- Klient projektu – používá se pro operace nativní pro Foundry, kde OpenAI nemá žádný ekvivalent. Příklady: výpis připojení, načítání vlastností projektu, povolení trasování.
-
Klient kompatibilní s OpenAI – používá se pro funkce Foundry, které vycházejí z konceptů OpenAI. Rozhraní Responses API, agenti, vyhodnocení a vyladění používají vzory požadavků a odpovědí ve stylu OpenAI. Tento klient vám také umožňuje přístup k přímo dostupným modelům Foundry (modely, které nejsou Azure-OpenAI, hostované v Foundry). Koncový bod projektu obsluhuje tento provoz na
/openaitrase.
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.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
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:
with project_client.get_openai_client() as openai_client:
response = openai_client.responses.create(
model="gpt-5.2",
input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")
Očekávaný výstup:
Response output: France has an area of approximately 213,011 square miles (551,695 square kilometers).
Vytvoření klienta projektu:
import com.azure.ai.projects.ProjectsClient;
import com.azure.ai.projects.ProjectsClientBuilder;
import com.azure.identity.DefaultAzureCredentialBuilder;
String endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
ProjectsClient projectClient = new ProjectsClientBuilder()
.credential(new DefaultAzureCredentialBuilder().build())
.endpoint(endpoint)
.buildClient();
```**Create and use an OpenAI-compatible client from your project:**
```java
OpenAIClient openAIClient = projectClient.getOpenAIClient();
Vytvoření klienta projektu:
import { DefaultAzureCredential } from "@azure/identity";
import { AIProjectClient } from "@azure/ai-projects";
import "dotenv/config";
const projectEndpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const deploymentName = "gpt-5.2";
const project = new AIProjectClient(projectEndpoint, new DefaultAzureCredential());
Vytvořte klienta kompatibilního s OpenAI z projektu:
const openAIClient = await project.getOpenAIClient();
const response = await openAIClient.responses.create({
model: deploymentName,
input: "What is the size of France in square miles?",
});
console.log(`Response output: ${response.output_text}`);
Vytvoření klienta projektu:
using Azure.AI.Projects.OpenAI;
using Azure.Identity;
using OpenAI.Responses;
string endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
AIProjectClient projectClient = new(
endpoint: new Uri(endpoint),
tokenProvider: new DefaultAzureCredential());
Vytvořte klienta kompatibilního s OpenAI z projektu:
#pragma warning disable OPENAI001
OpenAIResponseClient responseClient = projectClient.OpenAI.GetProjectResponsesClientForModel("gpt-5.2");
OpenAIResponse response = responseClient.CreateResponse("What is the speed of light?");
Console.WriteLine(response.GetOutputText());
#pragma warning restore OPENAI001
Co můžete dělat se sadou Foundry SDK
- Modely Access Foundry, včetně Azure OpenAI
- Použití služby agenta Foundry
- Spuštění dávkových vyhodnocení
- Povolení trasování aplikací
- Vyladění modelu
- Získání koncových bodů a klíčů pro Foundry Tools, místní orchestraci a další
Řešení problémů
Chyby ověřování
Pokud se zobrazí DefaultAzureCredential failed to retrieve a token:
Ověřte, že je Azure CLI přihlášený:
az account show az login # if not logged inKontrola přiřazení role RBAC:
- Ověřte, že máte v projektu Foundry alespoň roli uživatele Azure AI.
- Viz Přiřazení rolí Azure
Pro spravovanou identitu v produkčním prostředí:
- Ujistěte se, že má spravovaná identita přiřazenou příslušnou roli.
- Viz Konfigurace spravovaných identit
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 kvůli AttributeError nebo ModuleNotFoundError:
-
Kontrola verze sady SDK:
pip show azure-ai-projects # Python npm list @azure/ai-projects # JavaScript dotnet list package # .NET - Ověření zarovnání monikeru: Sada SDK 2.x vyžaduje portál Foundry, sada SDK 1.x vyžaduje Sadu Foundry Classic.
- Přeinstalace se správnými příznaky verze: Viz instalační příkazy v jednotlivých částech jazyka 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 modelům Azure OpenAI a přímým modelům Foundry (prostřednictvím rozhraní API odpovědí). 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žívat 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))
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 Podporované programovací jazyky 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 se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.
Následující fragment kódu ukazuje, jak přímo používat koncový bod Azure OpenAI /openai/v1 .
import com.azure.identity.AuthenticationUtil;
import com.azure.identity.DefaultAzureCredential;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.credential.BearerTokenCredential;
import java.util.function.Supplier;
DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build();
String endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
String deploymentName = "gpt-5.2";
Supplier<String> bearerTokenSupplier = AuthenticationUtil.getBearerTokenSupplier(
tokenCredential, "https://ai.azure.com/.default");
OpenAIClient openAIClient = OpenAIOkHttpClient.builder()
.baseUrl(endpoint)
.credential(BearerTokenCredential.create(bearerTokenSupplier))
.build();
ResponseCreateParams responseCreateParams = ResponseCreateParams.builder()
.input("What is the speed of light?")
.model(deploymentName)
.build();
Response response = openAIClient.responses().create(responseCreateParams);
System.out.println("Response output: " + response.getOutputText());
Další informace o používání sady OpenAI SDK najdete v tématu Podporované programovací jazyky Azure OpenAI.
const endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
const scope = "https://ai.azure.com/.default";
const azureADTokenProvider = getBearerTokenProvider(new DefaultAzureCredential(), scope);
const client = new OpenAI({ baseURL: endpoint, apiKey: azureADTokenProvider });
const response = await client.responses.create({
model: deploymentName,
input: "What is the size of France in square miles?",
});
console.log(`Response output: ${response.output_text}`);
Další informace o používání sady OpenAI SDK najdete v tématu Podporované programovací jazyky Azure OpenAI.
- 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 `ResponseClient` for the Azure OpenAI v1 endpoint. ```csharp using Azure.Identity; using Azure.Core; using OpenAI; using System; using System.ClientModel.Primitives; #pragma warning disable OPENAI001 const string directModelEndpoint = "https://<resource-name>.openai.azure.com/openai/v1/"; const string deploymentName = "gpt-5.2"; BearerTokenPolicy tokenPolicy = new( new DefaultAzureCredential(), "https://ai.azure.com/.default"); OpenAIResponseClient client = new( model: deploymentName, authenticationPolicy: tokenPolicy, // To use Entra // credential: new ApiKeyCredential("<YOUR-AZURE-OPENAI-API-KEY>") // To use APIKEY options: new OpenAIClientOptions() { Endpoint = new($"{directModelEndpoint}"), }); ResponseCreationOptions options = new ResponseCreationOptions { Temperature = (float)0.7, }; OpenAIResponse modelDirectResponse = client.CreateResponse( [ ResponseItem.CreateUserMessageItem("What is the size of France in square miles?"), ], options); Console.WriteLine($"[ASSISTANT]: {modelDirectResponse.GetOutputText()}"); #pragma warning restore OPENAI001 // The ResponseClient lets you interact with models and services in your project.
Další informace o používání sady OpenAI SDK najdete v tématu Podporované programovací jazyky Azure OpenAI.
Použití rozhraní agenta pro místní orchestraci
Microsoft Agent Framework je opensourcová sada SDK pro vytváření systémů s více agenty v kódu (například .NET a Python) s rozhraním nezávislém na poskytovateli cloudu.
Agent Framework použijte, pokud chcete definovat a orchestrovat agenty místně. Spárujte ji se sadou Foundry SDK, pokud chcete, aby se tito agenti spouštěli s modely Foundry nebo pokud chcete, aby Agent Framework orchestroval agenty hostované ve Foundry.
Další informace najdete v přehledu rozhraní Microsoft Agent Framework.
SDK nástroje Foundry
Foundry Tools (dříve Azure AI Services) jsou předpřipravená bodová ř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 azure AI Services můžete získat přístup k nástrojům Pro počítačové zpracování obrazu, zabezpečení obsahu, funkce Document Intelligence, jazyka, překladu a slévárství tokenů.
Koncový bod nástrojů Foundry: https://<your-resource-name>.cognitiveservices.azure.com/
Poznámka:
Koncové body používají název vašeho zdroje nebo vlastní subdoménu. Pokud vaše organizace nastavila vlastní subdoménu, nahraďte your-resource-name za your-custom-subdomain ve všech příkladech koncových bodů.
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 pro řeč
| Nástroj slévárny | Endpoint |
|---|---|
| Převod řeči na text (standardní) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Převod textu na řeč (neurální) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| Vlastní hlas | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Koncové body překladu
| Nástroj slévárny | Endpoint |
|---|---|
| Překlad textu | https://api.cognitive.microsofttranslator.com/ |
| Překlad dokumentů | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Následující části obsahují odkazy pro rychlý start pro sady SDK Foundry Tools a referenční informace.
