Een nieuwe verbinding toevoegen aan uw project

Belangrijk

Items die zijn gemarkeerd als voorbeeld in dit artikel, zijn momenteel beschikbaar als preview-versie. Deze preview wordt aangeboden zonder een service level agreement en Microsoft raadt dit niet aan voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure previews voor meer informatie.

In dit artikel leert u hoe u een nieuwe verbinding toevoegt in Microsoft Foundry-portal.

Met verbindingen kunt u zich verifiëren bij Microsoft en andere resources binnen uw Foundry-projecten. Ze zijn vereist voor scenario's zoals het bouwen van Standard-agents of het bouwen met hulpprogramma's voor agentkennis. Bepaalde verbindingen kunnen worden gemaakt in de Foundry-gebruikersinterface, terwijl andere verbindingen moeten worden geïmplementeerd via code in Bicep sjabloon. Bekijk onze foundry-samples op GitHub. Lees de onderstaande tabelbeschrijvingen voor meer informatie.

Voorwaarden

  • Als u nog geen project hebt, maakt u een project.

  • Zorg ervoor dat u uw project kunt openen in Microsoft Foundry.

  • Maak de resource waarmee u verbinding wilt maken, zoals een Azure AI Zoeken-service of een Azure Storage-account. Een resource die nog niet bestaat, wordt nog niet weergegeven in de lijst wanneer u ernaar bladert.

  • Zorg ervoor dat u gemachtigd bent om verbindingen met het project of de resource toe te voegen. Voor het toevoegen van verbindingen is de rol Foundry User, Foundry Owner of Azure Contributor (of hoger) vereist. Zie Op rollen gebaseerd toegangsbeheer voor meer informatie.

    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.

Verbindingstypen

Serviceverbindingstype Voorbeeld Beschrijving
Azure AI Zoeken Azure AI Zoeken is een Azure resource die ondersteuning biedt voor het ophalen van gegevens via vector- en tekstgegevens die zijn opgeslagen in zoekindexen. Vereist voor de implementatie van de Standard-agent.
Azure Storage Azure Storage is een cloudopslagoplossing voor het opslaan van ongestructureerde gegevens, zoals documenten, afbeeldingen, video's en toepassingsinstallatieprogramma's. Vereist voor de implementatie van de Standard-agent.
Azure Cosmos DB ✅ Azure Cosmos DB is een wereldwijd gedistribueerde databaseservice met meerdere modellen die lage latentie, hoge beschikbaarheid en schaalbaarheid biedt in meerdere regio's. Vereist voor de implementatie van de Standard-agent. Het maken van een verbinding wordt alleen ondersteund via code.
Azure OpenAI Azure OpenAI biedt toegang tot OpenAI-modellen, waaronder GPT-5, GPT-4o, GPT-image-1 en Embeddings, met Azure beveiligings- en bedrijfsmogelijkheden.
Application Insights Azure-toepassing Insights helpt bij het detecteren van prestatieafwijkingen, het diagnosticeren van problemen en het begrijpen van toepassingsgedrag.
Azure Key Vault Azure service voor het veilig opslaan en openen van geheimen. (Zie de beperkingen hieronder.)
Gieterij Maak verbinding met andere Foundry-resources.
OpenAI Maak verbinding met uw OpenAI-modellen.
SERP Serp maakt verbinding met pagina's met zoekresultaten (SERP) voor realtime gegevenstoegang. Ondersteunt scenario's waarvoor de meest recente zoekresultaten nodig zijn.
API-sleutel API-sleutelverbindingen verwerken verificatie met uw opgegeven doel op individuele basis.
Aangepaste sleutel Met aangepaste verbindingen kunt u veilig sleutels opslaan en openen tijdens het opslaan van gerelateerde eigenschappen, zoals doelen en versies. Deze verbindingen zijn handig wanneer u veel doelen of scenario's hebt waarbij u geen referentie nodig hebt om toegang te krijgen tot het doel. LangChain-scenario's zijn een veelvoorkomend voorbeeld. U beheert verificatie voor aangepaste verbindingen.
Basis leggen met Bing Search Hiermee maakt u verbinding met Bing Search om realtime ondersteuning vanuit het web te bieden voor query's. Hiermee kunnen agents verwijzen naar huidige webgegevens in antwoorden.
Serverless-model ✅ Serverloze modelverbindingen maken serverloze API-implementatie mogelijk. Het maken van een verbinding wordt alleen ondersteund via code.
Azure Databricks ✅ Azure Databricks-verbindingen geven Foundry Agents tijdens runtime toegang tot werkstromen en Genie Spaces. Het maken van een verbinding wordt alleen ondersteund via code.
SharePoint ✅ SharePoint is een Microsoft platform voor documentopslag en samenwerking. Hiermee kunnen agents toegang krijgen tot organisatiedocumenten en deze beheren. Het maken van een verbinding wordt alleen ondersteund via code.
Microsoft Fabric ✅ Met Fabric-dataagenten kunt u conversationele vraag-en-antwoordsystemen maken op basis van Fabric-gegevens. Maak de verbinding door het hulpprogramma Microsoft Fabric gegevensagent toe te voegen in de Foundry-portal of met behulp van de Azure Resource Manager REST API. Geef voor beide methoden de Fabric werkruimte- en artefact-id's op.
Basis leggen met Bing Custom Search ✅ Integreert met een aangepaste Bing-zoekinstantie voor op maat gemaakte webondersteuning. Het maken van een verbinding wordt alleen ondersteund via code.
AZURE APIM ✅ APIM ondersteunt governance voor AI-modellen die worden aangeroepen in Foundry Agent Service. Het maken van een verbinding wordt alleen ondersteund via code.
Gateway voor modellen ✅ Model Gateway ondersteunt governance voor AI-modellen die worden aangeroepen in Foundry Agent Service. Het maken van een verbinding wordt alleen ondersteund via code.
Copilot Studio omgeving Breng uw Copilot Studio-agenten naar Foundry Control Plane zodat u ze kunt bekijken. Maak de verbinding op het tabblad Beheren>Projectdetails>Verbonden bronnen in de Foundry-portal, waarbij u rechtstreeks verbinding maakt met uw Copilot Studio-omgeving.

Azure Key Vault beperkingen

Foundry slaat de verbindingsgegevens op in een beheerde Azure Key Vault als er geen Key Vault verbinding wordt gemaakt. Gebruikers die hun geheimen liever zelf beheren, kunnen hun eigen Azure Key Vault meenemen via een verbinding. Alle Foundry-projecten maken gebruik van een beheerde Azure Key Vault (niet weergegeven in uw abonnement). Als u uw eigen Azure Key Vault meebrengt, moet u het volgende weten:

  • Slechts één Azure Key Vault verbinding per Foundry-resource tegelijk.
  • U kunt een Azure Key Vault verbinding alleen verwijderen als er geen andere bestaande verbindingen zijn op het resource- of projectniveau van Foundry.
  • Geheime migratie wordt niet ondersteund; maak de verbindingen opnieuw nadat de Key Vault is gekoppeld.
  • Als u de onderliggende Azure Key Vault verwijdert, wordt de Foundry-resource verbroken (verbindingen zijn afhankelijk van opgeslagen geheimen).
  • Het verwijderen van geheimen in uw BYO-Key Vault kan verbindingen met andere services verbreken.

beperkingen voor Azure Databricks verbinding (preview)

Het ondersteunt drie verbindingstypen: Jobs, Genie en Overige. U kunt de ruimte Job of Genie kiezen die u wilt koppelen aan de verbinding in de Gebruikersinterface van Foundry. U kunt ook het andere verbindingstype gebruiken om uw agent toegang te geven tot werkruimtebewerkingen in Azure Databricks. Verificatie maakt gebruik van Microsoft Entra ID voor gebruikers of service-principals. Zie Jobs en Genie voor voorbeelden van het gebruik van deze connector. Het gebruik van deze verbinding is alleen beschikbaar via de Foundry SDK en is geïntegreerd in agents als een FunctionTool. Het gebruik van deze verbinding in Foundry Playground wordt momenteel niet ondersteund.

Een nieuwe verbinding maken

Gebruik de portal of een Bicep-sjabloon om een verbinding toe te voegen.

Volg deze stappen om een nieuwe verbinding te maken die beschikbaar is voor het huidige project.

  1. Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).

  2. Selecteer Manage in de navigatie rechtsboven.

  3. Selecteer Project details in het linkerdeelvenster.

  4. Selecteer het tabblad Verbonden bronnen.

  5. Selecteer Verbinding toevoegen.

  6. Selecteer de service waarmee u verbinding wilt maken in de lijst met beschikbare externe resources. Selecteer bijvoorbeeld Azure AI Zoeken.

  7. Blader naar en selecteer uw Azure AI Zoeken-service in de lijst met beschikbare services en selecteer vervolgens het type Authentication dat u voor de resource wilt gebruiken. Selecteer Verbinding toevoegen.

    Tip

    Verschillende verbindingstypen ondersteunen verschillende verificatiemethoden. Het gebruik van Microsoft Entra ID vereist mogelijk specifieke Azure op rollen gebaseerde toegangsmachtigingen voor uw ontwikkelaars. Ga naar Op rollen gebaseerd toegangsbeheer voor meer informatie.

  8. Controleer of de nieuwe verbinding wordt weergegeven in de lijst met verbonden resources.

Netwerkisolatie

Voor end-to-end netwerkisolatie met Foundry hebt u privé-eindpunten nodig om verbinding te maken met uw verbonden resource. Als uw Azure Storage account bijvoorbeeld is ingesteld op openbare netwerktoegang als Disabled, moet een privé-eindpunt worden geïmplementeerd in uw virtuele netwerk voor toegang in Foundry.

Raadpleeg de volgende documentatie voor meer informatie over het instellen van privé-eindpunten voor uw verbonden resources:

Privéresource Documentatie
Azure Storage Privé-eindpunten gebruiken
Azure Cosmos DB Configure Azure Private Link voor Azure Cosmos DB
Azure AI Zoeken Een privé-eindpunt maken voor een beveiligde verbinding
Azure OpenAI Virtuele netwerken configureren voor Azure AI-services
Application Insights Gebruik Azure Private Link om netwerken te verbinden met Azure Monitor

Opmerking

Verbindingen tussen abonnementen die worden gebruikt voor modelimplementatie worden niet ondersteund (Foundry, Azure OpenAI). U kunt geen verbinding maken met resources uit verschillende abonnementen voor modelimplementaties.

Verwante inhoud

  • Laatst bijgewerkt om