Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Dieses Dokument bezieht sich auf das Microsoft Foundry(klassische) Portal.
🔄 Wechseln Sie zur Microsoft Foundry-Dokumentation (neu), wenn Sie das neue Portal verwenden.
Hinweis
Dieses Dokument bezieht sich auf das Microsoft Foundry (neue) Portal.
Tip
Ein alternativer Artikel zu Hub-bezogenen Verbindungen ist verfügbar: Erstellen und Verwalten von Verbindungen (Hubs).
Important
Die in diesem Artikel markierten Elemente (Vorschau) sind aktuell als öffentliche Vorschau verfügbar. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und sollte nicht für Produktionsworkloads verwendet werden. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.
In diesem Artikel erfahren Sie, wie Sie eine neue Verbindung im Microsoft Foundry-Portal hinzufügen.
Verbindungen sind eine Möglichkeit, Microsoft und andere Ressourcen in Ihren Foundry-Projekten zu authentifizieren und zu nutzen. Sie sind für Szenarien wie das Erstellen von Standardagenten oder das Erstellen mit Agenten-Wissenstools erforderlich. Bestimmte Verbindungen können in der Foundry-Benutzeroberfläche erstellt werden, während andere eine Bereitstellung über Code in der Bicep-Vorlage erfordern. Sehen Sie sich unsere Foundry-Samples auf GitHub an. Lesen Sie die nachstehenden Tabellenbeschreibungen, um mehr zu erfahren.
Voraussetzungen
- Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie über keins verfügen, erstellen Sie ein kostenloses Azure-Konto, das ein kostenloses Testabonnement enthält.
- Wenn Sie kein Projekt haben, erstellen Sie ein Projekt.
Verbindungstypen
| Dienstverbindungstyp | Preview | Description |
|---|---|---|
| Azure KI-Suche | Azure AI Search ist eine Azure-Ressource, die das Abrufen von Informationen über Ihre in Suchindizes gespeicherten Vektor- und Textdaten unterstützt. Erforderlich für die Standard-Agent-Bereitstellung. | |
| Azure Storage | Azure Storage ist eine Cloudspeicherlösung zum Speichern unstrukturierter Daten wie Dokumente, Bilder, Videos und Anwendungsinstallationsprogrammen. Erforderlich für die Standard-Agent-Bereitstellung. | |
| Azure Cosmos DB (ein Microsoft-Datenbankdienst) | ✅ | Azure Cosmos DB ist ein global verteilter, multimodellbasierter Datenbankdienst mit geringer Latenz, hoher Verfügbarkeit und Skalierbarkeit in mehreren geografischen Regionen. Erforderlich für die Standard-Agent-Bereitstellung. Die Verbindungserstellung wird nur über Code unterstützt. |
| Azure OpenAI | Azure OpenAI ist ein Dienst, der Zugriff auf OpenAI-Modelle bietet, einschließlich der GPT-5-, GPT-4o-, DALLE-3- und Embeddings-Modellreihe mit den Sicherheits- und Unternehmensfunktionen von Azure. | |
| Application Insights | Azure Application Insights ist ein Dienst, der Es Entwicklern ermöglicht, Leistungsanomalien automatisch zu erkennen, Probleme zu diagnostizieren und tiefe Einblicke in die Anwendungsnutzung und das Verhalten zu erhalten. | |
| Azure Key Vault (ein Dienst zur sicheren Verwaltung kryptografischer Schlüssel) | Azure-Dienst zum sicheren Speichern von und Zugreifen auf Geheimnisse. (Siehe Einschränkungen unten) | |
| Gießerei | Stellen Sie eine Verbindung mit anderen Foundry-Ressourcen her. | |
| OpenAI | Stellen Sie eine Verbindung mit Ihren OpenAI-Modellen her. | |
| Serp | Serp verbindet sich mit Suchergebnisseiten (SERP) für den Echtzeitdatenzugriff. Unterstützt Szenarien, die die neuesten Suchergebnisse benötigen. | |
| API key | Die API-Schlüsselverbindung verarbeitet die Authentifizierung für Ihr angegebenes Ziel auf individueller Basis. | |
| Benutzerdefinierter Schlüssel | Benutzerdefinierte Verbindungen ermöglichen Ihnen das sichere Speichern von und den Zugriff auf Schlüssel bei gleichzeitigem Speichern zugehörige Eigenschaften wie Ziele und Versionen. Benutzerdefinierte Verbindungen sind nützlich, wenn Sie viele Ziele oder Fälle haben, in denen Sie keine Anmeldeinformationen für den Zugriff benötigen. LangChain-Szenarien sind ein gutes Beispiel für die Verwendung benutzerdefinierter Dienstverbindungen. Benutzerdefinierte Verbindungen verwalten die Authentifizierung nicht, somit müssen Sie die Authentifizierung selbst verwalten. | |
| Grounding mit Bing-Suche | Verbindet sich mit Bing Search, um eine Echtzeit-Basis für Web-Suchanfragen bereitzustellen. Ermöglicht KI-Agents, auf aktuelle Webdaten in Antworten zu verweisen. | |
| Serverloses Modell | ✅ | Serverlose Modellverbindungen ermöglichen die Serverlose API-Bereitstellung. Die Verbindungserstellung wird nur über Code unterstützt. |
| Azure Databricks | ✅ | Azure Databricks Connector ermöglicht Es Ihnen, Ihre Foundry Agents mit Azure Databricks zu verbinden, um während der Laufzeit auf Workflows und Genie Spaces zuzugreifen. Die Verbindungserstellung wird nur über Code unterstützt. |
| SharePoint | ✅ | SharePoint ist eine Microsoft-Plattform für die Dokumentspeicherung und Zusammenarbeit. Es ermöglicht Agents den Zugriff auf und die Verwaltung von Organisationsdokumenten. Die Verbindungserstellung wird nur über Code unterstützt. |
| Microsoft Fabric | ✅ | KI-Fähigkeiten ermöglichen Es Ihnen, ihre eigenen Unterhaltungs-Q&A-Systeme auf Fabric mithilfe von generativen KI zu erstellen. Die Verbindungserstellung wird nur über Code unterstützt. |
| Grounding mit der benutzerdefinierten Bing-Suche | ✅ | Integriert in eine benutzerdefinierte Bing-Suchinstanz für maßgeschneidertes Web-Grounding. Die Verbindungserstellung wird nur über Code unterstützt. |
| Azure APIM | ✅ | APIM ermöglicht die Governance von AI-Modellen, die im Foundry Agent-Dienst aufgerufen werden. Die Verbindungserstellung wird nur über Code unterstützt. |
| Modellgateway | ✅ | Das Modellgateway ermöglicht die Governance von AI-Modellen, die im Foundry Agent-Dienst aufgerufen werden. Die Verbindungserstellung wird nur über Code unterstützt. |
| Dienstverbindungstyp | Preview | Description |
|---|---|---|
| Azure KI-Suche | Azure AI Search ist eine Azure-Ressource, die das Abrufen von Informationen über Ihre in Suchindizes gespeicherten Vektor- und Textdaten unterstützt. Erforderlich für die Standard-Agent-Bereitstellung. | |
| Azure Storage | Azure Storage ist eine Cloudspeicherlösung zum Speichern unstrukturierter Daten wie Dokumente, Bilder, Videos und Anwendungsinstallationsprogrammen. Erforderlich für die Standard-Agent-Bereitstellung. | |
| Azure Cosmos DB (ein Microsoft-Datenbankdienst) | ✅ | Azure Cosmos DB ist ein global verteilter, multimodellbasierter Datenbankdienst mit geringer Latenz, hoher Verfügbarkeit und Skalierbarkeit in mehreren geografischen Regionen. Erforderlich für die Standard-Agent-Bereitstellung. Die Verbindungserstellung wird im Foundry Management Center nicht unterstützt. |
| Azure OpenAI | Azure OpenAI ist ein Dienst, der Zugriff auf OpenAI-Modelle bietet, einschließlich der GPT-5-, GPT-4o-, DALLE-3- und Embeddings-Modellreihe mit den Sicherheits- und Unternehmensfunktionen von Azure. | |
| Application Insights | Azure Application Insights ist ein Dienst, der Es Entwicklern ermöglicht, Leistungsanomalien automatisch zu erkennen, Probleme zu diagnostizieren und tiefe Einblicke in die Anwendungsnutzung und das Verhalten zu erhalten. | |
| Azure Key Vault (ein Dienst zur sicheren Verwaltung kryptografischer Schlüssel) | Azure-Dienst zum sicheren Speichern von und Zugreifen auf Geheimnisse. (Siehe Einschränkungen unten) | |
| Gießerei | Stellen Sie eine Verbindung mit anderen Foundry-Ressourcen her. | |
| OpenAI | Stellen Sie eine Verbindung mit Ihren OpenAI-Modellen her. | |
| Serp | Serp verbindet sich mit Suchergebnisseiten (SERP) für den Echtzeitdatenzugriff. Unterstützt Szenarien, die die neuesten Suchergebnisse benötigen. | |
| API key | Die API-Schlüsselverbindung verarbeitet die Authentifizierung für Ihr angegebenes Ziel auf individueller Basis. | |
| Benutzerdefinierter Schlüssel | Benutzerdefinierte Verbindungen ermöglichen Ihnen das sichere Speichern von und den Zugriff auf Schlüssel bei gleichzeitigem Speichern zugehörige Eigenschaften wie Ziele und Versionen. Benutzerdefinierte Verbindungen sind nützlich, wenn Sie viele Ziele oder Fälle haben, in denen Sie keine Anmeldeinformationen für den Zugriff benötigen. LangChain-Szenarien sind ein gutes Beispiel für die Verwendung benutzerdefinierter Dienstverbindungen. Benutzerdefinierte Verbindungen verwalten die Authentifizierung nicht, somit müssen Sie die Authentifizierung selbst verwalten. | |
| Grounding mit Bing-Suche | Verbindet sich mit Bing Search, um eine Echtzeit-Basis für Web-Suchanfragen bereitzustellen. Ermöglicht KI-Agents, auf aktuelle Webdaten in Antworten zu verweisen. | |
| Serverloses Modell | ✅ | Serverlose Modellverbindungen ermöglichen die Serverlose API-Bereitstellung. |
| Azure Databricks | ✅ | Azure Databricks Connector ermöglicht Es Ihnen, Ihre Foundry Agents mit Azure Databricks zu verbinden, um während der Laufzeit auf Workflows und Genie Spaces zuzugreifen. |
| SharePoint | ✅ | SharePoint ist eine Microsoft-Plattform für die Dokumentspeicherung und Zusammenarbeit. Es ermöglicht Agents den Zugriff auf und die Verwaltung von Organisationsdokumenten. |
| Microsoft Fabric | ✅ | KI-Fähigkeiten ermöglichen Es Ihnen, ihre eigenen Unterhaltungs-Q&A-Systeme auf Fabric mithilfe von generativen KI zu erstellen. |
| Grounding mit der benutzerdefinierten Bing-Suche | ✅ | Integriert in eine benutzerdefinierte Bing-Suchinstanz für maßgeschneidertes Web-Grounding. |
Azure Key Vault-Einschränkungen
Foundry speichert Verbindungsdetails in einem verwalteten Azure Key Vault, wenn keine Key Vault-Verbindung erstellt wird. Benutzer, die ihre Geheimnisse lieber selbst verwalten möchten, können ihren eigenen Azure Key Vault über eine Verbindung mitbringen. Alle Foundry-Projekte verwenden einen verwalteten Azure Key Vault (nicht in Ihrem Abonnement angezeigt). Wenn Sie Ihren eigenen Azure Key Vault mitbringen, beachten Sie Folgendes:
- Jeweils nur eine Azure Key Vault-Verbindung pro Foundry-Ressource.
- Sie können eine Azure Key Vault-Verbindung nur löschen, wenn keine anderen Verbindungen auf der Gießereiressource oder Projektebene vorhanden sind.
- Die Geheimnismigration wird nicht unterstützt. Erstellen Sie Verbindungen nach dem Anfügen des Key Vault neu.
- Durch das Löschen des zugrunde liegenden Azure Key Vault wird die Foundry-Ressource unterbrochen (Verbindungen hängen von gespeicherten geheimen Schlüsseln ab).
- Das Löschen geheimer Schlüssel in Ihrem BYO Key Vault kann Verbindungen zu anderen Diensten unterbrechen.
Einschränkungen der Azure Databricks-Verbindung (Vorschau)
Es unterstützt drei Verbindungstypen - Jobs, Genie und Other. Sie können den Bereich "Auftrag" oder "Genie" auswählen, den Sie dieser Verbindung zuordnen möchten, während Sie die Verbindung in der Foundry-Benutzeroberfläche einrichten. Sie können auch den Verbindungstyp "Sonstige" verwenden und Ihrem Agent den Zugriff auf Arbeitsbereichsvorgänge in Azure Databricks ermöglichen. Die Authentifizierung erfolgt über Microsoft Entra ID für Benutzende oder Dienstprinzipale. Beispiele für die Verwendung dieses Connectors finden Sie unter Jobs und Genie. Hinweis: Die Verwendung dieser Verbindung steht nur über das Foundry SDK im Code zur Verfügung und ist als FunctionTool in Agents integriert (einzelheiten hierzu finden Sie in den obigen Beispielen). Die Verwendung dieser Verbindung im Foundry Playground wird derzeit nicht unterstützt.
Eine neue Verbindung erstellen
Verwenden Sie das Portal oder eine Bicep-Vorlage, um eine Verbindung hinzuzufügen.
Führen Sie die folgenden Schritte aus, um eine neue Verbindung zu erstellen, die für das aktuelle Projekt verfügbar ist.
Tip
Da Sie den linken Bereich im Microsoft Foundry-Portal anpassen können, werden möglicherweise andere Elemente als in diesen Schritten angezeigt. Wenn Sie nicht sehen, wonach Sie suchen, wählen Sie ... Mehr am unteren Rand des linken Bereichs.
Melden Sie sich bei Microsoft Foundry an. Stellen Sie sicher, dass der Umschalter "Neue Gießerei " deaktiviert ist. Diese Schritte beziehen sich auf Foundry (klassisch).
Melden Sie sich bei Microsoft Foundry an. Stellen Sie sicher, dass die Umschaltfläche Neues Foundry aktiviert ist. Diese Schritte beziehen sich auf Foundry (neu).
Wählen Sie im unteren linken Navigationsbereich die Option Verwaltungscenter aus.
Wählen Sie aus dem Abschnitt ProjektVerbundene Ressourcen aus.
Wählen Sie im Abschnitt Verbundene Ressourcen die Option + Neue Verbindung aus.
Wählen Sie den Dienst, mit dem Sie eine Verbindung herstellen möchten, aus der Liste der verfügbaren externen Ressourcen aus. Wählen Sie beispielsweise Azure KI-Suche aus.
Suchen Sie in der Liste der verfügbaren Dienste nach Ihrem Azure KI-Suche-Dienst, und wählen Sie ihn aus. Wählen Sie anschließend den Typ der Authentifizierung aus, der für die Ressource verwendet werden soll. Wählen Sie Verbindung hinzufügen aus.
Tip
Verschiedene Verbindungstypen unterstützen unterschiedliche Authentifizierungsmethoden. Die Verwendung von Microsoft Entra ID erfordert möglicherweise bestimmte rollenbasierte Azure-Zugriffsberechtigungen für Ihre Entwickler. Weitere Informationen finden Sie unter Rollenbasierte Zugriffssteuerung.
Nachdem der Dienst verbunden wurde, wählen Sie "Schließen" aus.
Melden Sie sich bei Microsoft Foundry an. Stellen Sie sicher, dass der Umschalter "Neue Gießerei " deaktiviert ist. Diese Schritte beziehen sich auf Foundry (klassisch).
Melden Sie sich bei Microsoft Foundry an. Stellen Sie sicher, dass die Umschaltfläche Neues Foundry aktiviert ist. Diese Schritte beziehen sich auf Foundry (neu).
Wählen Sie Bedienen in der oberen rechten Navigationsleiste aus.
Wählen Sie " Administrator " im linken Bereich aus.
Wählen Sie ihren Projektnamen in der Liste "Alle Projekte verwalten " aus.
Wählen Sie in der oberen rechten Ecke die Option "Verbindung hinzufügen" aus.
Wählen Sie den Dienst, mit dem Sie eine Verbindung herstellen möchten, aus der Liste der verfügbaren externen Ressourcen aus. Wählen Sie beispielsweise Azure KI-Suche aus.
Suchen Sie in der Liste der verfügbaren Dienste nach Ihrem Azure KI-Suche-Dienst, und wählen Sie ihn aus. Wählen Sie anschließend den Typ der Authentifizierung aus, der für die Ressource verwendet werden soll. Wählen Sie Verbindung hinzufügen aus.
Tip
Verschiedene Verbindungstypen unterstützen unterschiedliche Authentifizierungsmethoden. Die Verwendung von Microsoft Entra ID erfordert möglicherweise bestimmte rollenbasierte Azure-Zugriffsberechtigungen für Ihre Entwickler. Weitere Informationen finden Sie unter Rollenbasierte Zugriffssteuerung.
Netzwerkisolation
Für die End-to-End-Netzwerkisolation mit Foundry benötigen Sie private Endpunkte, um eine Verbindung mit Ihrer verbundenen Ressource herzustellen. Wenn Ihr Azure Storage-Konto beispielsweise auf den öffentlichen Netzwerkzugriff als deaktiviert festgelegt ist, sollte ein privater Endpunkt in Ihrem virtuellen Netzwerk bereitgestellt werden, um auf foundry zuzugreifen.
Weitere Informationen zum Festlegen privater Endpunkte auf Ihre verbundenen Ressourcen finden Sie in der folgenden Dokumentation:
| Private Ressource | Documentation |
|---|---|
| Azure Storage | Verwenden privater Endpunkte |
| Azure Cosmos DB (ein Microsoft-Datenbankdienst) | Konfigurieren des privaten Azure-Links für Azure Cosmos DB |
| Azure KI-Suche | Erstellen eines privaten Endpunkts für eine sichere Verbindung |
| Azure OpenAI | Sichern von Azure OpenAI in einem virtuellen Netzwerk mit privaten Endpunkten |
| Application Insights | Verwenden von Azure Private Link zum Verbinden von Netzwerken mit Azure Monitor |
Hinweis
Abonnementübergreifende Verbindungen, die für die Modellbereitstellung verwendet werden, werden nicht unterstützt (Foundry, Azure OpenAI). Sie können keine Verbindung mit Ressourcen aus verschiedenen Abonnements für Modellbereitstellungen herstellen.