Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Note
Ten dokument odnosi się do portalu Microsoft Foundry (klasycznego).
🔄 Przejdź do dokumentacji Microsoft Foundry (nowej), jeśli korzystasz z nowego portalu.
Note
Ten dokument odnosi się do portalu Microsoft Foundry (nowy).
Tworzenie zasobu foundry umożliwia odblokowanie dostępu do modeli, agentów i narzędzi za pomocą ujednoliconego zestawu zestawów SDK i punktów końcowych. W tym artykule opisano, do czego służy każdy zestaw SDK i którego punktu końcowego należy używać.
| SDK | Do czego to służy | Endpoint |
|---|---|---|
| Foundry SDK | Funkcje specyficzne dla rozwiązania Foundry z interfejsami zgodnymi z technologią OpenAI. Obejmuje dostęp do modeli bezpośrednich Foundry za pośrednictwem interfejsu API Odpowiedzi (nie Uzupełniania Czatu). | https://<resource-name>.services.ai.azure.com/api/projects/<project-name> |
| OpenAI SDK | Najnowsze modele i funkcje zestawu OpenAI SDK z pełną powierzchnią interfejsu API openAI. Modele bezpośrednie Foundry dostępne za pośrednictwem interfejsu API dopełniania rozmów (nie przez odpowiedzi). | https://<resource-name>.openai.azure.com/openai/v1 |
| Zestawy SDK narzędzi Foundry | Wstępnie utworzone rozwiązania (Rozpoznawanie wizji, Rozpoznawanie mowy, Bezpieczeństwo treści i inne). | Punkty końcowe specyficzne dla narzędzi (różnią się w zależności od usługi). |
| Struktura agenta | Koordynacja wielu agentów w kodzie. Niezależne od chmury. | Używa punktu końcowego projektu z użyciem Foundry SDK. |
Note
Typy zasobów: Zasób foundry zawiera wszystkie punkty końcowe wymienione wcześniej. Zasób usługi Azure OpenAI zapewnia tylko /openai/v1 punkt końcowy.
Uwierzytelniania: Przykłady w tym miejscu używają identyfikatora Entra firmy Microsoft (DefaultAzureCredential). Klucze API działają na /openai/v1. Przekaż klucz jako api_key zamiast dostawcy tokenu.
Prerequisites
-
Konto Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz bezpłatne konto platformy Azure, które obejmuje subskrypcję bezpłatnej wersji próbnej.
Aby utworzyć zasoby usługi Foundry i zarządzać nimi, posiadaj jedną z następujących ról RBAC na platformie Azure:
- Użytkownik sztucznej inteligencji platformy Azure (rola z najmniejszymi uprawnieniami na potrzeby programowania)
- Menedżer projektów sztucznej inteligencji platformy Azure (do zarządzania projektami foundry)
- Współautor lub właściciel (w przypadku uprawnień na poziomie subskrypcji)
Aby uzyskać szczegółowe informacje na temat uprawnień poszczególnych ról, zobacz Kontrola dostępu oparta na rolach dla usługi Microsoft Foundry.
Zainstaluj wymagane środowiska uruchomieniowe języka, narzędzia globalne i rozszerzenia programu VS Code zgodnie z opisem w temacie Przygotowywanie środowiska projektowego.
Important
Przed rozpoczęciem upewnij się, że środowisko deweloperskie jest gotowe.
Ten artykuł koncentruje się na krokach specyficznych dla scenariusza , takich jak instalacja, uwierzytelnianie i uruchamianie przykładowego kodu zestawu SDK.
Foundry SDK
Zestaw SDK rozwiązania Foundry łączy się z pojedynczym punktem końcowym projektu, który zapewnia dostęp do najpopularniejszych funkcji rozwiązania Foundry:
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Note
Jeśli twoja organizacja używa niestandardowej poddomeny, zastąp ciąg <resource-name> ciągiem <your-custom-subdomain> w adresie URL punktu końcowego.
Upraszcza to konfigurację aplikacji. Zamiast zarządzać wieloma punktami końcowymi, należy je skonfigurować.
Zainstaluj zestaw SDK
Note
Ten artykuł dotyczy projektu Foundry. Pokazany tutaj kod nie działa w przypadku projektu opartego na centrum. Aby uzyskać więcej informacji, zobacz Typy projektów.
Note
Wersje zestawu SDK: Zestaw SDK w wersji zapoznawczej 2.x jest przeznaczony dla nowego portalu i interfejsu API rozwiązania Foundry. Zestaw SDK GA w wersji 1.x jest przeznaczony bezpośrednio dla klasycznej wersji Foundry. Upewnij się, że obserwowane przykłady są zgodne z zainstalowanym pakietem.
Biblioteka klienta usługi Azure AI Projects dla języka Python to ujednolicona biblioteka umożliwiająca jednoczesne używanie wielu bibliotek klienckich przez połączenie z pojedynczym punktem końcowym projektu.
Uruchom to polecenie, aby zainstalować stabilne pakiety dla klasycznych projektów Foundry.
pip install azure-ai-projects azure-identity openai
Uruchom te polecenia, aby zainstalować pakiety w wersji zapoznawczej dla projektów Foundry.
pip install --pre azure-ai-projects
pip install azure-identity openai
Biblioteka klienta usługi Azure AI Projects dla języka Java (wersja zapoznawcza) to ujednolicona biblioteka, która umożliwia jednoczesne używanie wielu bibliotek klienckich przez połączenie z pojedynczym punktem końcowym projektu.
Important
Elementy oznaczone jako (wersja zapoznawcza) w tym artykule są aktualnie dostępne w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie zalecamy korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.
Dodaj te pakiety do instalacji:
com.azure.ai.projectscom.azure.core
Biblioteka kliencka usługi Azure AI Projects dla języka JavaScript to ujednolicona biblioteka, która umożliwia jednoczesne używanie wielu bibliotek klienckich przez połączenie z pojedynczym punktem końcowym projektu.
Uruchom to polecenie, aby zainstalować bieżące pakiety JavaScript dla klasycznych projektów Foundry.
npm install @azure/ai-projects @azure/identity
Uruchom to polecenie, aby zainstalować pakiety JavaScript w wersji zapoznawczej dla projektów foundry.
npm install @azure/ai-projects@beta @azure/identity
Biblioteka klienta usługi Azure AI Projects dla platformy .NET to ujednolicona biblioteka, która umożliwia używanie wielu bibliotek klienckich razem przez nawiązanie połączenia z jednym punktem końcowym projektu.
Uruchom to polecenie, aby dodać pakiet Azure.AI.Projects do projektu platformy .NET.
dotnet add package Azure.AI.Projects --version 1.2
Korzystanie z zestawu SDK usługi Foundry
Zestaw SDK uwidacznia dwa typy klientów, ponieważ narzędzia Foundry i OpenAI mają różne kształty interfejsu API:
- Klient projektu — służy do operacji natywnych dla platformy Foundry, w których interfejs OpenAI nie ma odpowiednika. Przykłady: wyświetlanie listy połączeń, pobieranie właściwości projektu, włączanie śledzenia.
-
Klient zgodny z interfejsem OpenAI — służy do obsługi funkcji rozwiązania Foundry, która opiera się na pojęciach dotyczących interfejsu OpenAI. Interfejs API odpowiedzi, agenci, oceny i dostrajanie używają wzorców żądań/odpowiedzi według wzorców OpenAI. Ten klient zapewnia również dostęp do bezpośrednich modeli Foundry (modeli innych niż Azure-OpenAI hostowanych w Foundry). Punkt końcowy projektu obsługuje ten ruch na
/openaitrasie.
Większość aplikacji używa obu klientów. Użyj klienta projektu do instalacji i konfiguracji, a następnie skorzystaj z klienta kompatybilnego z OpenAI do uruchamiania agentów, ocen oraz wywoływania modeli (w tym bezpośrednich modeli Foundry).
Utwórz klienta projektu:
from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
project = AIProjectClient(
endpoint="https://<resource-name>.services.ai.azure.com/api/projects/<project-name>",
credential=DefaultAzureCredential())
Utwórz klienta zgodnego z platformą OpenAI na podstawie projektu:
openai_client = project.inference.get_azure_openai_client(api_version="2024-10-21")
response = openai_client.responses.create(
model="gpt-5.2",
input="What is the speed of light?",
)
print(response.output_text)
Utwórz 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();
Utwórz klienta zgodnego z platformą OpenAI na podstawie projektu:
OpenAIClient openAIClient = projectClient.getOpenAIClient();
Utwórz klienta projektu:
import { AIProjectClient } from '@azure/ai-projects';
import { DefaultAzureCredential } from '@azure/identity';
const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const project = new AIProjectClient(endpoint, new DefaultAzureCredential());
Utwórz klienta zgodnego z platformą OpenAI na podstawie projektu:
const openAIClient = await project.getOpenAIClient();
Utwórz 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());
Utwórz klienta zgodnego z platformą OpenAI na podstawie 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 można zrobić za pomocą zestawu SDK usługi Foundry
- Modele odnajdowania dostępu, w tym Azure OpenAI
- Korzystanie z usługi agenta programu Foundry
- Uruchamianie ocen w chmurze
- Włączanie śledzenia aplikacji
- Dostrajanie modelu
- Uzyskiwanie punktów końcowych i kluczy dla narzędzi Foundry, lokalnej orkiestracji i nie tylko
OpenAI SDK
Użyj zestawu OpenAI SDK, jeśli chcesz uzyskać pełną powierzchnię interfejsu API OpenAI i maksymalną zgodność klienta. Ten punkt końcowy zapewnia dostęp do modeli usługi Azure OpenAI i modeli bezpośrednich rozwiązania Foundry (za pośrednictwem interfejsu API uzupełniania czatów). Nie zapewnia dostępu do funkcji specyficznych dla rozwiązania Foundry, takich jak agenci i oceny.
Tworzenie klienta openAI na podstawie projektu
Ten fragment kodu używa elementu AIProjectClient, aby zażądać klienta OpenAI przypisanego do twojego projektu.
# Use the AIProjectClient to create an OpenAI client for your project
openai_client = project.get_openai_client(api_version="2024-10-21")
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}")
Poniższy fragment kodu pokazuje, jak bezpośrednio używać punktu końcowego usługi 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://cognitiveservices.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))
Aby uzyskać więcej informacji, zobacz Języki programowania obsługiwane przez usługę Azure OpenAI.
Ten fragment kodu używa elementu , AIProjectClient aby zażądać klienta OpenAI z projektu Foundry.
# Use the AIProjectClient to create an OpenAI client for your project
openai_client = project.get_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}")
Poniższy fragment kodu pokazuje, jak bezpośrednio używać punktu końcowego usługi 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://cognitiveservices.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))
Aby uzyskać więcej informacji, zobacz Języki programowania obsługiwane przez usługę Azure OpenAI
Important
Elementy oznaczone jako (wersja zapoznawcza) w tym artykule są aktualnie dostępne w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie zalecamy korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.
Ten fragment kodu pobiera OpenAIClient z ProjectsClient, aby można było wysyłać żądania OpenAI przez Foundry.
OpenAIClient openAIClient = projectClient.getOpenAIClient();
Aby uzyskać więcej informacji na temat korzystania z zestawu OpenAI SDK, zobacz Języki programowania obsługiwane przez usługę Azure OpenAI.
Aby uzyskać więcej informacji na temat korzystania z zestawu OpenAI SDK, zobacz Języki programowania obsługiwane przez usługę Azure OpenAI
Ten fragment kodu używa klienta projektu do utworzenia klienta openAI, którego można użyć ponownie w żądaniach.
// Use the AIProjectClient to create an OpenAI client for your project
const openAIClient = await project.getOpenAIClient();
Aby uzyskać więcej informacji na temat korzystania z zestawu OpenAI SDK, zobacz Języki programowania obsługiwane przez usługę Azure OpenAI.
Aby uzyskać więcej informacji na temat korzystania z zestawu OpenAI SDK, zobacz Języki programowania obsługiwane przez usługę Azure OpenAI
Zainstaluj pakiet OpenAI:
Uruchom to polecenie, aby dodać bibliotekę klienta OpenAI do projektu platformy .NET.
dotnet add package OpenAI
Gdy się to uda, interfejs wiersza polecenia platformy .NET potwierdza, że zainstalowano pakiet OpenAI.
Poniższy fragment kodu pokazuje, jak utworzyć klienta OpenAI bezpośrednio przy użyciu punktu końcowego usługi Azure OpenAI w wersji 1.
Ten fragment kodu konfiguruje
DefaultAzureCredential, kompilujeOpenAIClientOptionsi tworzy elementResponseClientdla punktu końcowego Azure OpenAI v1.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://cognitiveservices.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.
Aby uzyskać więcej informacji na temat korzystania z zestawu OpenAI SDK, zobacz Języki programowania obsługiwane przez usługę Azure OpenAI.
Aby uzyskać więcej informacji na temat korzystania z zestawu OpenAI SDK, zobacz Języki programowania obsługiwane przez usługę Azure OpenAI
Używanie Agent Framework do orkiestracji lokalnej
Microsoft Agent Framework to zestaw SDK typu open source do tworzenia systemów wieloagentowych w kodzie (na przykład .NET i Python) z interfejsem niezależnym od dostawcy chmury.
Użyj struktury agentów, jeśli chcesz definiować i organizować agentów lokalnie. Połącz go z Foundry SDK, jeśli chcesz, aby ci agenci działali na modelach Foundry, lub gdy chcesz, aby Agent Framework koordynował agentów hostowanych w Foundry.
Aby uzyskać więcej informacji, zobacz Omówienie programu Microsoft Agent Framework.
Zestawy SDK narzędzi Foundry
Narzędzia Foundry Tools (dawniej Azure AI Services) to wstępnie utworzone rozwiązania punktowe z dedykowanymi zestawami SDK. Użyj następujących punktów końcowych, aby korzystać z narzędzi Foundry.
Którego punktu końcowego należy użyć?
Wybierz punkt końcowy w zależności od potrzeb:
Użyj punktu końcowego usług Azure AI, aby uzyskać dostęp do narzędzi przetwarzania obrazów, bezpieczeństwa zawartości, analizy dokumentów, języka, tłumaczenia i tokenów.
Adres końcowy narzędzi Foundry: https://<your-resource-name>.cognitiveservices.azure.com/
Note
Punkty końcowe używają nazwy zasobu lub niestandardowej poddomeny. Jeśli twoja organizacja skonfiguruje niestandardową poddomenę, zastąp ciąg your-resource-name we your-custom-subdomain wszystkich przykładach punktów końcowych.
W przypadku narzędzi usługi Speech and Translation Foundry użyj punktów końcowych w poniższych tabelach. Zastąp elementy zastępcze informacjami o zasobie.
Punkty końcowe mowy
| Narzędzie Foundry | Endpoint |
|---|---|
| Zamiana mowy na tekst (Standardowa) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Przekształcanie tekstu na mowę (neuronowe) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| głos niestandardowy | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Punkty końcowe tłumaczenia
| Narzędzie Foundry | Endpoint |
|---|---|
| Tłumaczenie tekstu | https://api.cognitive.microsofttranslator.com/ |
| Tłumaczenie dokumentu | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
W poniższych sekcjach znajdują się linki szybkiego startu dla zestawów SDK narzędzi Foundry i informacje referencyjne.
