Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Visar för närvarande:Foundry-portalversion - (klassisk)Växla till version för den nya Foundry-portalen
En Foundry-resurs ger enhetlig åtkomst till modeller, agenter och verktyg. Den här artikeln förklarar vilken SDK och slutpunkt som ska användas för ditt scenario.
Foundry SDK är en SDK för tunn klient som exponerar alla Foundry-projekt-API:er via en enda projektslutpunkt. SDK:er på högre nivå bygger på det – till exempel är Agent Framework-paketet foundry beroende av Foundry SDK för att få åtkomst till Foundry-modeller, verktyg och projektkonfiguration.
| SDK | Vad det är till för | Slutpunkt |
|---|---|---|
| Foundry SDK | SDK för tunnklient för alla Foundry-projektets API:er. Åtkomst till Foundry-modeller och plattformsverktyg (filsökning, kodtolk, webbsökning, minne, SharePoint, WorkIQ, Fabric IQ, MCP). | https://<resource-name>.services.ai.azure.com/api/projects/<project-name> |
| Agentramverket | Enhetlig dirigering med flera agenter för värdbaserade agenter och system med flera agenter, som är tillgängliga i C#/.NET och Python. Paketet foundry är beroende av Foundry SDK för projektåtkomst. |
Svars-API:et i projektslutpunkten via FoundryChatClient. |
| OpenAI SDK | Hela OpenAI API:et, inklusive embeddingar och Foundry-modeller som säljs av Azure via Chat Completions. Bästa svarstid och maximal OpenAI-kompatibilitet. | https://<resource-name>.openai.azure.com/openai/v1 |
| Anthropic SDK | Anthropic Claude-modeller distribuerade i Foundry. | https://<resource-name>.services.ai.azure.com/anthropic |
| SDK:er för Foundry Tools | Fördefinierade lösningar (vision, tal, innehållssäkerhet med mera). | Verktygsspecifika slutpunkter. |
Välj ditt SDK:
- Använda Foundry SDK när du skapar appar med agenter, utvärderingar eller Foundry-specifika funktioner
- Använd Agent Framework för värdbaserade agenter eller system med flera agenter i kod med hjälp av svars-API:et i C#/.NET eller Python
- Använd OpenAI SDK när maximal OpenAI-kompatibilitet eller lägsta svarstid krävs, när du genererar inbäddningar eller när du använder modeller som säljs av Azure via chattavslutningar
- Använd Anthropic SDK när du arbetar med Anthropic Claude modeller som distribuerats i Foundry
- Använd Foundry Tools SDK:er när du arbetar med specifika AI-tjänster (vision, tal, språk osv.)
Observera
Resurstyper: En Foundry-resurs innehåller alla slutpunkter som tidigare angavs. En Azure OpenAI-resurs tillhandahåller endast slutpunkten /openai/v1.
Authentication: Exempel här använder Microsoft Entra ID (DefaultAzureCredential). API-nycklar fungerar på /openai/v1. Skicka nyckeln som api_key i stället för en tokenprovider.
Förutsättningar
-
Ett Azure konto med en aktiv prenumeration. Om du inte har ett skapar du ett fritt Azure konto, som innehåller en kostnadsfri utvärderingsprenumeration.
Ha den Azure RBAC-roll som krävs för din uppgift i det smalaste omfånget:
Foundry-användare i Foundry-projektet för daglig utveckling.
Viktigt
Foundrys RBAC-roller har nyligen namnändrats. Foundry User, Foundry Owner, Foundry Account Owner och Foundry Project Manager hette tidigare Azure AI-användare, Azure AI-ägare, Azure AI-kontoägare och Azure AI Project Manager. Du kanske fortfarande ser de tidigare namnen på vissa platser medan namnbytet distribueras. Roll-ID:na och kärnbehörigheterna ändras inte av namnbytet.
Använd Foundry Project Manager i Foundry-projektet för att hantera ett befintligt projekt och dess anslutningar.
Foundry-kontoägare på Foundry-resursen för att skapa projekt eller hantera resurser på kontonivå. Tilldela den här rollen endast för målresursgruppen när du behöver skapa en Foundry-resurs.
Aktivera resursgrupptilldelningen precis i tid via Microsoft Entra Privileged Identity Management (PIM) och inaktivera den efter etableringen. Vanliga utvecklare och användare av körningsmiljön behöver inte den här tilldelningen med utökade behörigheter.
Mer information om behörigheter för varje roll finns i Role-baserad åtkomstkontroll för Microsoft Foundry.
Installera nödvändiga språkkörningar, globala verktyg och VS Code-tillägg enligt beskrivningen i Förbereda utvecklingsmiljön.
Verifiera förutsättningar
Bekräfta att varje kontroll returnerar det angivna resultatet innan du fortsätter:
Bekräfta att Azure CLI använder den avsedda prenumerationen och klientorganisationen:
az account show --query "{subscription:name, tenant:tenantId}" --output tableKommandot slutförs utan fel och visar den förväntade prenumerationen och klientorganisationen.
Bekräfta att dina lokala autentiseringsuppgifter kan begära en Foundry-åtkomsttoken utan att visa token:
az account get-access-token --resource https://ai.azure.com --query expiresOn --output tsvKommandot avslutas utan fel och visar tokenens utgångstid. Om det misslyckas, kör du
az loginmed en identitet som har den Foundry-roll som krävs.Bekräfta att du har den RBAC-roll som krävs i Azure portalen under Foundry resource>Access control (IAM).
- Kör
python --version. Kommandot slutförs utan fel och visar att Python 3.9 eller senare används.
- Kör
node --version. Kommandot avslutas utan fel och rapporterar att Node.js 22 eller senare används.
- Kör
dotnet --version. Kommandot avslutas utan fel och anger .NET 8 eller senare.
- Kör
java --version. Kommandot avslutas utan fel och rapporterar Java 17 eller senare.
Bekräfta att projektslutpunkten har det här formatet:
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>.Bekräfta att distributionen
gpt-5-miniär klar:az cognitiveservices account deployment show \ --name <resource-name> \ --resource-group <resource-group> \ --deployment-name gpt-5-mini \ --query properties.provisioningState \ --output tsvKommandot returnerar
Succeeded. Använd det distribuerade namnet i kodexemplen om distributionen har ett annat namn.
Foundry SDK
Foundry SDK ansluter till en enda projektslutpunkt som ger åtkomst till de mest populära Foundry-funktionerna:
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Observera
Om din organisation använder en anpassad underdomän ersätter du <resource-name> med <your-custom-subdomain> i slutpunkts-URL:en.
Den här metoden förenklar programkonfigurationen. I stället för att hantera flera slutpunkter konfigurerar du en.
Installera SDK
Observera
Den här artikeln gäller för ett Foundry-projekt. Koden som visas här fungerar inte för ett hubbbaserat projekt. Mer information finns i Typer av projekt.
Observera
SDK-versioner: Den här artikeln beskriver installationen av 1.x SDK. Kontrollera att exemplen som du följer matchar det installerade paketet. Växla till den nya foundry-portaldokumentationen för att visa artikeln för 2.x.
| SDK-version | Portalversion | Status | Python-paket |
|---|---|---|---|
| 2.x | Foundry (ny) | Stabil | azure-ai-projects>=2.0.0 |
| 1.x | Foundry (klassisk) | Stabil | azure-ai-projects==1.0.0 |
Klientbiblioteket Azure AI Projects för Python är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.
Kör det här kommandot för att installera 1.x-paketen för klassiska Foundry-projekt.
pip install openai azure-identity azure-ai-projects==1.0.0
| SDK-version | Portalversion | Status | Java-paket |
|---|---|---|---|
| 1.x | Gjuteriets klassiker | Pensionerad | Det finns inget Java paket som stöds för den här klassiska sökvägen. Använd com.azure:azure-ai-projects:2.2.0 med ett aktuellt Foundry-projekt. |
| SDK-version | Portalversion | Status | JavaScript-paket |
|---|---|---|---|
| 1.0.1 | Gjuteriets klassiker | Stabil | @azure/ai-projects |
| SDK-version | Portalversion | Status | .NET-paket |
|---|---|---|---|
| 1.1.0 (GA) | Gjuteriets klassiker | Stabil | Azure.AI.Projects |
Sökvägen till Java SDK för Foundry Classic har utgått. Det klassiska 1.x-projekt-SDK:t nådde inte allmän tillgänglighet för Java och det tillbakadragna förhandsversionspaketet azure-ai-inference stöds inte.
Viktigt
Starta eller migrera inte Java-utveckling med den klassiska SDK-sökvägen. Växla till den aktuella Foundry SDK-guiden och använd GA Azure AI Projects-klientbiblioteket för Java med ett aktuellt Foundry-projekt.
För ett aktuellt Foundry-projekt lägger du till följande beroende till din Maven pom.xml:
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-projects</artifactId>
<version>2.2.0</version>
</dependency>
Klientbiblioteket Azure AI Projects för JavaScript är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.
Kör det här kommandot för att installera 1.x JavaScript-paketen för klassiska Foundry-projekt.
npm install @azure/ai-projects@1.0.1 @azure/identity
Klientbiblioteket Azure AI Projects för .NET är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.
Kör de här kommandona för att lägga till 1.x-Azure AI SDK-paket för klassiska Foundry-projekt.
# 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
Att använda Foundry SDK
SDK:n exponerar två klienttyper eftersom Foundry och OpenAI har olika API-former:
- Project klient – Använd för Foundry-inbyggda åtgärder där OpenAI inte har någon motsvarighet. Exempel: visa anslutningar, hämta projektegenskaper, aktivera spårning.
-
OpenAI-kompatibel klient – Använd för Foundry-funktioner som bygger på OpenAI-begrepp. Svars-API: et, agenter, utvärderingar och finjustering använder alla mönster för begäran/svar i OpenAI-stil. Den här klienten ger dig också åtkomst till Foundry-direktmodeller (icke-Azure-OpenAI modeller som finns i Foundry). Projektslutpunkten hanterar den här trafiken på
/openaivägen.
De flesta appar använder båda klienterna. Använd projektklienten för konfiguration och använd sedan Den OpenAI-kompatibla klienten för att köra agenter, utvärderingar och anropa modeller (inklusive Foundry-direktmodeller).
Skapa en projektklient:
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(),
)
Skapa en OpenAI-kompatibel klient från projektet:
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)
Den Java första framgångsvägen för Foundry Classic har dragits tillbaka. Det tidigare azure-ai-inference exemplet skapar inte en klassisk projektklient och använder ett API-anrop som inte är tillgängligt i den paketversionen.
För Java utveckling använder du com.azure:azure-ai-projects:2.2.0 med ett aktuellt Foundry-projekt och följer den aktuella Foundry SDK-guiden. Den här aktuella SDK-sökvägen lägger inte till Java stöd för klassiska Foundry-projekt.
Skapa en projektklient:
const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const deployment = "gpt-4o";
const project = new AIProjectClient(endpoint, new DefaultAzureCredential());
Skapa en OpenAI-kompatibel klient från projektet:
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);
Skapa en projektklient:
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());
Skapa en OpenAI-kompatibel klient från projektet:
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);
Vad du kan göra med Foundry SDK
- Access Foundry Models, inklusive Azure OpenAI
- Använd Foundry Agent-tjänsten
- Köra molnutvärderingar
- Aktivera appspårning
- Finjustera en modell
- Hämta slutpunkter och nycklar för Foundry Tools, lokal orkestrering med mera
Felsökning
Autentiseringsfel
Om du ser DefaultAzureCredential failed to retrieve a token:
Verifiera att Azure CLI är autentiserad
az account show az login # if not logged inKontrollera RBAC-rolltilldelning:
Bekräfta att du har minst rollen Foundry-användare i Foundry-projektet
Viktigt
Foundrys RBAC-roller har nyligen namnändrats. Foundry User, Foundry Owner, Foundry Account Owner och Foundry Project Manager hette tidigare Azure AI-användare, Azure AI-ägare, Azure AI-kontoägare och Azure AI Project Manager. Du kanske fortfarande ser de tidigare namnen på vissa platser medan namnbytet distribueras. Roll-ID:na och kärnbehörigheterna ändras inte av namnbytet.
För hanterad identitet i produktion:
- Kontrollera att den hanterade identiteten har tilldelats rätt roll
- Se Konfigurera hanterade identiteter
Fel vid slutpunktskonfiguration
Om du ser Connection refused eller 404 Not Found:
- Kontrollera att resurs- och projektnamnen matchar din faktiska distribution
-
Kontrollera formatet för slutpunkts-URL: Bör vara
https://<resource-name>.services.ai.azure.com/api/projects/<project-name> -
För anpassade underdomäner: Ersätt
<resource-name>med din anpassade underdomän
SDK-versionsmatchningar
Om kodexempel misslyckas med AttributeError eller ModuleNotFoundError:
Kontrollera SDK-versionen:
pip show azure-ai-projects # Python npm list @azure/ai-projects # JavaScript dotnet list package # .NETInstallera om med rätt versionsflaggor: Se installationskommandon i varje språkavsnitt ovan
OpenAI SDK
Använd OpenAI SDK när du vill ha den fullständiga OpenAI API-ytan och maximal klientkompatibilitet. Den här slutpunkten ger åtkomst till Azure OpenAI-modeller och Foundry-direktmodeller (via API för chattslutsättningar). Den ger inte åtkomst till Foundry-specifika funktioner som agenter och utvärderingar.
Följande kodfragment visar hur du använder Azure OpenAI /openai/v1 slutpunkt direkt.
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))
Mer information finns i Azure Programmeringsspråk som stöds av OpenAI. Förväntade utdata:
{
"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)."
}
Mer information finns i Azure Programmeringsspråk som stöds av OpenAI
Viktigt
Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller har begränsade funktioner. Mer information finns i Supplemental Terms of Use for Microsoft Azure Previews.
Följande kodfragment visar hur du använder Azure OpenAI /openai/v1 slutpunkt direkt.
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());
Mer information om hur du använder OpenAI SDK finns i Azure OpenAI-programmeringsspråk som stöds.
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);
Mer information om hur du använder OpenAI SDK finns i Azure OpenAI-programmeringsspråk som stöds.
- Installera OpenAI-paketet: Kör det här kommandot för att lägga till OpenAI-klientbiblioteket i ditt .NET projekt.
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
Mer information om hur du använder OpenAI SDK finns i Azure OpenAI-programmeringsspråk som stöds.
Agentramverk
Microsoft Agent Framework är en SDK med öppen källkod för C#/.NET och Python som tillhandahåller enhetlig dirigering med flera agenter och konsekventa abstraktioner för byggagenter och system med flera agenter. Det är det rekommenderade orkestreringsskiktet för hostade agenter i Foundry.
- Om du tidigare använde AutoGen eller Semantic Kernel för orkestrering med flera agenter (samordna flera agenter för att arbeta tillsammans med uppgifter) bör du betrakta Agent Framework som ditt primära orkestreringslager. Det hjälper dig att undvika att kombinera flera orkestrerings-SDK:er som löser liknande samordningsuppgifter, vilket kan lägga till motstridiga abstraktioner och beroenden.
- Om du redan har omfattande befintlig orkestreringskod, är beroende av produktspecifika funktioner eller ställs inför komplexa migreringskrav utvärderar du dessa krav innan du konsoliderar agentramverket.
Kör koden som en värdbaserad agent
Huvudartikeln för kodbaserade agenter i Foundry är hostade agenter. Skriv din agent med Agent Framework, paketera den som en containeravbildning eller zip för källkoden och låt Foundry köra den med en hanterad slutpunkt, automatisk skalning på isolerade virtuella Mikrodatorer, en dedikerad Microsoft Entra agentidentitet, sessionstillstånd och observerbarhet från slutpunkt till slutpunkt.
Värdhanterade agenter är det rekommenderade alternativet när du vill ha en slutpunkt som hanteras av Foundry och är nätverksåtkomlig, och som andra appar eller agenter kan anropa. Se Distribuera din första värdbaserade agent.
Skapa agenter i kod utanför Foundry med svars-API:et
Om du är värd för din agent utanför Foundry – i din egen process eller infrastruktur – kan du också använda Agent Framework för att anropa svars-API:et direkt i projektslutpunkten . Agent Framework ansluter via providern FoundryChatClient , som riktar sig till:
{project_endpoint}/openai/v1/responses
Genom att gå igenom projektslutpunkten – i stället för en OpenAI-slutpunkt på resursnivå – får din agent:
- Foundry-modeller från katalogen (Azure OpenAI- och Foundry-direktmodeller) via ett API.
- Plattformsverktyg utöver OpenAI-verktygsuppsättningen, inklusive filsökning, kodtolk, minne, webbsökning, MCP-servrar, SharePoint, WorkIQ och Fabric IQ.
- Projektavgränsade data, verktygsautentisering för OBO (On-Behalf-Of) samt projektets spårning, innehållsfilter och identitetskonfiguration.
Det här mönstret är additivt för värdbaserade agenter, inte ett alternativ – samma Agent Framework-kod kan anropa svars-API:et från din egen process idag och paketeras som en värdbaserad agent senare när du vill ha en Foundry-hanterad slutpunkt. Se Snabbstart: Skapa agenter med hjälp av svars-API:et.
En fullständig jämförelse av agenttyper och värdalternativ finns i Vad är Microsoft Foundry Agent Service?.
SDK:er för Foundry Tools
Foundry Tools (tidigare Azure AI Services) är fördefinierade punktlösningar med dedikerade SDK:er. Använd följande slutpunkter för att arbeta med Foundry Tools.
Vilken slutpunkt ska du använda?
Välj en slutpunkt baserat på dina behov:
Använd slutpunkten Azure AI Services för att få åtkomst till Visuellt innehåll, Content Safety, Document Intelligence, Language, Translation och Token Foundry Tools.
Slutpunkt för Foundry Tools: https://<your-resource-name>.cognitiveservices.azure.com/
Observera
Slutpunkter använder antingen ditt resursnamn eller en anpassad underdomän. Om din organisation har konfigurerat en anpassad underdomän ersätter du your-resource-name med your-custom-subdomain i alla slutpunktsexempel.
Om dina arbetsbelastningar använder funktioner i Azure AI-språk som tas bort – till exempel attitydanalys, extrahering av nyckelfraser, sammanfattning, entitetslänkning, CLU eller CQA – bör du planera att migrera till Foundry-alternativen från Microsoft. För ny utveckling bör du överväga att använda Foundry SDK eller den OpenAI-kompatibla slutpunkten enligt beskrivningen tidigare i den här artikeln. Se Migrera från Language Studio till Microsoft Foundry.
För verktyg för tal och översättning använder du slutpunkterna i följande tabeller. Ersätt platshållarna med din resursinformation.
Talslutpunkter
| Gjutningsverktyg | Slutpunkt |
|---|---|
| Tal till text (standard) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Text-till-tal (neuralt) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| Anpassad röst | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Översättningsslutpunkter
| Gjutningsverktyg | Slutpunkt |
|---|---|
| Textöversättning | https://api.cognitive.microsofttranslator.com/ |
| Dokumentöversättning | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Språkslutpunkter
| Gjutningsverktyg | Slutpunkt |
|---|---|
| Textanalys | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com |
Viktigt
Den 20 mars 2027 kommer Azure Language Studio att dra tillbaka och migrera till Microsoft Foundry. Alla funktioner och framtida förbättringar kommer att vara tillgängliga i Microsoft Foundry.
Den 31 mars 2029 upphör följande Azure Language-funktioner (supporten upphör). Före det datumet bör användarna migrera befintliga arbetsbelastningar och registrera nya projekt till Microsoft Foundry-modeller för förbättrad förståelse av naturligt språk och förenklad programintegrering:
- Extrahering av nyckelfras
- Sentimentanalys och åsiktsutvinning
- Anpassad textklassificering
- Konversationsspråksförståelse (CLU)
- Svar på anpassad fråga (CQA)
- Arbetsflöde för orkestrering
- Sammanfattning (extraktiv och abstrakt, för dokument och konversationer)
- Entitetslänkning
Grundläggande funktioner med fortsatt stöd: Språkidentifiering, PII-identifiering, Text Analytics för hälsa, fördefinierad NER och anpassad NER.
Migreringsalternativ finns i Migrera från Language Studio till Microsoft Foundry.