Migreren vanuit de Foundry-portal (klassiek)

Microsoft Foundry heeft zich ontwikkeld door verschillende naamgevings- en architectuurwijzigingen. Als u overstapt van de klassieke portalervaring, helpt dit artikel u bij het plannen en uitvoeren van de overgang met verwijzingstoewijzingen voor terminologie, mogelijkheden, SDK's en portalnavigatie.

Opmerking

Productnaamgeving: het AI-platform van Microsoft heeft zich ontwikkeld van Azure AI Studio-→ Azure AI Foundry → tot Microsoft Foundry (actueel). Op dezelfde manier is onze portfolio met AI-services ontwikkeld met het platform van Azure Cognitive Services → Azure AI Services → naar Foundry Tools (actueel). Ondanks de ontwikkeling van het platform blijft het Azure resourcetype Microsoft.CognitiveServices/accounts. Alle namen in deze documentatie verwijzen naar hetzelfde ontwikkelende platform.

Voorwaarden

  • Een Azure-account met een actief abonnement. Maak er gratis een.
  • Een Foundry-project.
  • Voor SDK-migratie: Python 3.9+ of .NET 8+, met azure-ai-projects 2.x- en openai-pakketten geïnstalleerd.
  • Voor resource-upgrade: de rol Eigenaar of Inzender voor de Azure OpenAI-resource die u wilt upgraden.

Belangrijk

Belangrijkste migratiedatums:

Uw migratie plannen

Volg deze stappen om over te stappen van de klassieke portal naar de huidige Foundry-portal:

  1. Bekijk terminologiewijzigingen. Scan de terminologiemapping om de omgedoopte concepten en nieuwe brontypen te leren kennen.
  2. Controleer de functievergelijking. Gebruik de functievergelijkingstabel om mogelijkheden te identificeren die nieuw, uitgebreid of alleen klassiek zijn.
  3. Werk uw SDK-pakketten bij. Vervang afgeschafte pakketten met behulp van de SDK-toewijzingstabel .
  4. Agenten migreren naar de Antwoorden-API. Herschrijf agents die de Assistants API gebruiken om de Responses API te gebruiken voor de beëindiging in augustus 2026.
  5. Controleer of uw Foundry-resourceregio ondersteuning biedt voor de response-API. De Response-API en Foundry Agent Service zijn niet beschikbaar in elke Azure regio. Als uw Foundry-resource zich in een niet-ondersteunde regio bevindt, werken agents en andere antwoorden-API-functies niet in de huidige portal. Controleer de beschikbaarheidslijst voor de antwoorden-API-regio voordat u migreert.
  6. Valideer in de nieuwe portal. Gebruik de portalnavigatiereferentie om uw werkstromen in de huidige ervaring te controleren.

Belangrijk

De Antwoorden-API is niet beschikbaar in alle Azure regio's. Als uw Foundry-resource zich in een niet-ondersteunde regio bevindt, kunt u geen agents maken of uitvoeren in de huidige Foundry-portal. Controleer voordat u gaat migreren of uw resource zich in een ondersteunde regio bevindt. Als dit niet het probleem is, maakt u een nieuwe Foundry-resource in een ondersteunde regio.

Terminologietoewijzing

De volgende tabel wijst klassieke concepten toe aan hun huidige equivalenten.

Concept Klassieke term Huidige term Notities
Portal (hoofdpagina) Klassiek Foundry-portaal Gieterijportal Schakelaar in de portalbanner wisselt tussen hen.
Portalinstellingen Beheercentrum Sectie Bedienen Navigatie is opnieuw georganiseerd.
Hulpmiddelsoort Azure OpenAI + Hub Gieterijbron Enkel AIServices soort met subprojecten.
AI-services Azure AI-services Gieterijgereedschappen Spraak, Visie, Taal, Inhoudsveiligheid, Inhoudsbegip.
Modelfacturering Model-as-a-Service (MaaS) Directe modellen van Foundry Modellen van eerstepartij worden rechtstreeks gefactureerd via Azure-meters.
RBAC-rollen Cognitive Services OpenAI-gebruiker Foundry-gebruiker, Foundry-projectmanager, Foundry-eigenaar Nieuwe rollen met scheiding van besturings- en gegevensvlak.
API-wire-protocol Api voor assistenten Antwoord-API Het beëindigen van de assistent-API: 26 augustus 2026.
API-versiebeheer api-version Maandelijkse parameters v1 stabiele routes Er is geen versieparameter vereist.
Gespreksstatus Draadjes Gesprekken Gesprekken slaan items op (berichten, hulpprogramma-aanroepen, uitvoer), niet alleen berichten.
Chatberichten Berichten Artikelen Items zijn een superset van berichten.
Uitvoering Uitvoermodi (asynchroon, gepollt) Antwoorden (standaard synchroniseren) Er is geen polling loop vereist.
Agentdefinitie Assistenten/agents Agent versies Versiebeheer, met expliciet type (prompt, werkstroom, gehost).
Agent maken create_agent() create_version() Maakt gebruik van PromptAgentDefinition.
Eindpunten Meerdere (openai, azureml, cognitiveservices, zoeken, spraak) Eindpunt voor één project + OpenAI v1-eindpunt Vereenvoudigd eindpuntbeheer.
Documentatie Klassieke documenten Huidige documenten Inhoud in twee afzonderlijke documentensets.

Belangrijk

De rollen Foundry RBAC zijn onlangs hernoemd. Foundry User, Foundry Owner, Foundry Account Owner en Foundry Project Manager zijn eerder benoemd Azure AI-gebruiker, Azure AI-eigenaar Azure AI-accounteigenaar en Azure AI Project Manager. Het kan zijn dat u op sommige plekken nog steeds de vorige namen ziet terwijl de naamswijziging wordt doorgevoerd. De rol-id's en basismachtigingen worden niet gewijzigd door de naamswijziging.

SDK-toewijzing

Gebruik de volgende tabel om te bepalen welke SDK-pakketten zijn toegewezen aan de huidige Foundry-ervaring en welke ze vervangen.

SDK-pakket Klassiek equivalent Status Notities
openai azure-ai-inference Gebruiken voor modeldeductie azure-ai-inference wordt op 26 augustus 2026 buiten gebruik gesteld.
OpenAI() met base_url AzureOpenAI() Standaardclient gebruiken Azure-specifieke code verwijderd.
azure-ai-projects 2.x azure-ai-projects 1.x Stabiel — is gericht op de nieuwe portal 1.x is gericht op de klassieke portalervaring.
azure-ai-projects 2.x azure-ai-generative Stabiel Mogelijkheden zijn samengevoegd in de projectclient.
azure-ai-projects 2.x azure-ai-ml Stabiel Voor hub-naar-project-migratiescenario's.
azure-ai-projects (extern) + azure-ai-evaluation (lokaal) azure-ai-evaluation (zelfstandig) Stabiel Externe evaluaties via projectclient; lokale evaluaties zijn ongewijzigd.
azure-search-documents (via projectverbindingen) azure-search-documents Stabiel Afzonderlijk pakket, detecteerbaar via projectclient.

Waarschuwing

Zorg ervoor dat de SDK-versie overeenkomt met uw portal-ervaring. Als u een 2.x SDK-voorbeeld gebruikt met een 1.x-installatie (of omgekeerd), worden fouten veroorzaakt.

In het volgende voorbeeld ziet u de meest voorkomende SDK-migratie. Vervang de Azure-specifieke AzureOpenAI-client door de standaardclient OpenAI.

Klassiek (vóór):

from openai import AzureOpenAI

client = AzureOpenAI(
    azure_endpoint="https://my-resource.openai.azure.com",
    api_key="my-key",
    api_version="2024-12-01-preview"
)

Huidige waarde (na):

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

client = OpenAI(
    base_url="https://my-project.services.ai.azure.com/openai/v1",
    default_headers={"Authorization": f"Bearer {get_bearer_token_provider(DefaultAzureCredential(), 'https://cognitiveservices.azure.com/.default')()}"}
)

Functievergelijking

In de volgende tabellen worden de beschikbaarheid van functies vergeleken tussen de klassieke en huidige portalervaringen.

Beschikbaar in beide portals

Kenmerk Klassiek Huidige Notities
Foundry-projecten ✅ ✅
Chatfuncties voltooien ✅ ✅
Fijnregeling ✅ ✅
Evaluaties ✅ ✅ Uitgebreid in de huidige portal
Modelcatalogus ✅ ✅ Uitgevouwen in de huidige portal

Nieuw in de huidige portal

Deze functies zijn alleen beschikbaar in de huidige Foundry-portal:

Kenmerk Status
Antwoord-API GA
Agents v2 (Antwoorden-API) GA
Hulpprogrammacatalogus (1.400+ hulpprogramma's) GA (controleer het label op afzonderlijke hulpprogramma's in de catalogus om te bepalen of deze ALGEMEEN of preview zijn)
Werkstromen met meerdere agents Voorbeeld
Agentgeheugen Voorbeeld
Agent publiceren naar M365/Teams GA
Foundry IQ Voorbeeld
Gehoste agents GA
A2A-protocol Voorbeeld
Controlevlak van Foundry Voorbeeld

Uitsluitend klassiek (overgang vereist)

Kenmerk Klassiek Huidige Migratieactie
Azure OpenAI-resources ✅ Foundry-resource gebruiken Een upgrade uitvoeren naar een Foundry-resource
Hubprojecten ✅ Niet zichtbaar Overschakelen naar klassieke portal of migreren naar Foundry-projecten

De klassieke portal maakt gebruik van één aanpasbaar linkerdeelvenster voor alle navigatie, met beheercentrum onderaan. Het huidige portaal verdeelt de functies over zes hoofdrubrieken, waarvan elk een eigen linkerdeelvenster heeft.

Schermopname van de startpagina van de huidige Foundry-portal.

Sectie Scope Wat u daar vindt
Home Geselecteerd project Project overzicht en snelle acties
Ontdek Geselecteerd project Modelcatalogus en benchmarking van modellen
Bouwen Geselecteerd project Agenten, modellen, speeltuinen, evaluaties, fine-tuning
Bedienen Alle projecten Naleving, vlootstatus, tracering, bedrijfsmiddelen
beheer Geselecteerd project en de bijbehorende resource Quotum, AI Gateway, resourcedetails, projectdetails
Docs N/A Documentatiekoppelingen

Binnen Build worden items in het linkerdeelvenster gegroepeerd onder de sectiekoppen Maken (Agents, Modellen, Services, Hulpprogramma's, Kennis, Geheugen, Beveiligingen, Gegevens) en Optimaliseren (Evaluaties, Fijnafstemming).

De volgende tabel wijst veelgebruikte klassieke portallocaties toe aan hun huidige equivalenten.

Taak Klassieke portallocatie Huidige portallocatie
Modelimplementaties weergeven Modellen en eindpunten in het linkerdeelvenster Bouwen>Modellen
Een speeltuin openen Speeltuinen in het linkerdeelvenster Bouwen>Modellen> een model selecteren
Agents bouwen Agents in het linkerdeelvenster Bouwen>Agenten
Bladeren door de modelcatalogus Modelcatalogus in het linkerdeelvenster Ontdek>Modelcatalogus
Evaluaties weergeven Evaluatie in het linkerdeelvenster Compilatie>Evaluaties
Een model verfijnen Afstemmen in het linkerdeelvenster Bouwen>Fine-tuning
Traceren en monitoren Tracering in het linkerdeelvenster Bedienen>Tracering
Quota beheren Beheercentrum>Quotum Beheer>Quotum
Gebruikers en machtigingen beheren Beheercentrum>Gebruikers Beheren>Projectgegevens>Gebruikers
Alle projecten en resources weergeven Beheercentrum>Alle resources Vervolgkeuzelijst voor projectnaam >Alle projecten weergeven
Verbonden middelen Beheercentrum>Verbonden bronnen Beheren>Projectgegevens>Gekoppelde resources
Veilige kaders en inhoudsfilters Begeleidingssystemen + controles in het linkerdeelvenster Bedienen>Naleving

Schakelen tussen portalervaringen

U kunt op elk gewenst moment schakelen tussen de klassieke en huidige portalervaringen. Met de wisselknop blijft uw huidige context behouden, zoals het project waarin u werkt.

Tip

In de huidige portal worden alleen Foundry-projecten weergegeven. Als u toegang nodig hebt tot hubprojecten of andere resourcetypen, gaat u terug naar de klassieke portal.

  1. Zoek de wisselknop New Foundry in de bovenste banner.
  2. Selecteer de wisselknop om te schakelen tussen de klassieke en huidige ervaringen.
  3. De pagina wordt opnieuw geladen met de geselecteerde portalinterface.

Veelvoorkomende migratieproblemen oplossen

Symptoom Oorzaak Resolutie
ModuleNotFoundError of onverwacht API-gedrag De SDK-versie komt niet overeen met uw portaldoel Controleer de SDK-toewijzingstabel en installeer de juiste pakketversie
Projecten ontbreken in de nieuwe portal Hubprojecten zijn niet zichtbaar in de huidige portal Schakel over naar de klassieke portal voor toegang tot hubprojecten of migreer naar Foundry-projecten (artikel wordt weergegeven in de klassieke documentatie)
Verbindingsfouten voor eindpunten Oude URL's met meerdere eindpunten worden niet meer opgelost Bijwerken naar het indelingsformaat voor één enkele projecteindpunt (https://<project>.services.ai.azure.com)
AuthenticationError met nieuwe client API-sleutel die wordt gebruikt met OpenAI() client zonder de juiste header Gebruik DefaultAzureCredential met een bearer token-provider, zoals wordt weergegeven in het SDK-migratievoorbeeld
Agentcode retourneert 404 of MethodNotAllowed API-aanroepen van assistenten die worden verzonden naar een eindpunt van de antwoorden-API Agentcode herschrijven voor het gebruik van de Antwoorden-API (create_version() in plaats van create_agent())
Agents zijn niet beschikbaar in de huidige portal Foundry-resource bevindt zich in een regio die geen ondersteuning biedt voor de Antwoorden-API Een Foundry-resource maken in een ondersteunde regio

Verwante inhoud

  • Last updated on