Udostępnij przez


Dodawanie nowego połączenia do projektu

Uwaga / Notatka

Ten dokument odnosi się do portalu Microsoft Foundry (klasycznego).

🔄 Przejdź do dokumentacji Microsoft Foundry (nowej), jeśli korzystasz z nowego portalu.

Uwaga / Notatka

Ten dokument odnosi się do portalu Microsoft Foundry (nowy).

Tip

Dostępny jest artykuł na temat połączeń specyficznych dla centrum: Tworzenie i zarządzanie połączeniami (Hubs).

Important

Elementy oznaczone (wersja zapoznawcza) w tym artykule są obecnie 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 Uzupełniające warunki korzystania z wersji zapoznawczych platformy Microsoft Azure.

Z tego artykułu dowiesz się, jak dodać nowe połączenie w portalu Microsoft Foundry.

Połączenia to sposób uwierzytelniania i korzystania zarówno z firmy Microsoft, jak i innych zasobów w projektach rozwiązania Foundry. Są one wymagane w scenariuszach, takich jak tworzenie Standardowych Agentów lub tworzenie z wykorzystaniem narzędzi wiedzy agenta. Niektóre połączenia można utworzyć w interfejsie użytkownika rozwiązania Foundry, podczas gdy inne wymagają wdrożenia za pomocą kodu w szablonie Bicep. Zobacz nasze przykłady foundry na GitHubie. Przeczytaj poniższe opisy tabel, aby dowiedzieć się więcej.

Wymagania wstępne

Typy połączeń

Typ połączenia z usługą Preview Description
Wyszukiwanie AI platformy Azure Azure AI Search to zasób platformy Azure, który obsługuje pobieranie informacji za pośrednictwem wektora i danych tekstowych przechowywanych w indeksach wyszukiwania. Wymagany jest do wdrożenia Agenta Standardowego.
Azure Storage Azure Storage to rozwiązanie magazynu w chmurze do przechowywania danych bez struktury, takich jak dokumenty, obrazy, filmy wideo i instalatory aplikacji. Wymagany jest do wdrożenia Agenta Standardowego.
Azure Cosmos DB Azure Cosmos DB to globalnie rozproszona, wielomodelowa usługa bazy danych, która oferuje małe opóźnienia, wysoką dostępność i skalowalność w wielu regionach geograficznych. Wymagany jest do wdrożenia Agenta Standardowego. Tworzenie połączenia jest obsługiwane tylko za pośrednictwem kodu.
Azure OpenAI Azure OpenAI to usługa, która zapewnia dostęp do modeli OpenAI, w tym GPT-5, GPT-4o, DALLE-3 oraz serii modeli Embeddings, z zabezpieczeniami i możliwościami dla przedsiębiorstw, które oferuje platforma Azure.
Application Insights Azure Application Insights to usługa, która umożliwia deweloperom automatyczne wykrywanie anomalii wydajności, diagnozowanie problemów i uzyskiwanie szczegółowych informacji o użyciu i zachowaniu aplikacji.
Azure Key Vault Usługa platformy Azure do bezpiecznego przechowywania i uzyskiwania dostępu do wpisów tajnych. (Zobacz ograniczenia poniżej)
Odlewnia Połącz się z innymi zasobami rozwiązania Foundry.
OpenAI Nawiąż połączenie z modelami OpenAI.
Serp SERP łączy się ze stronami wyników wyszukiwarki w celu uzyskania dostępu do danych w czasie rzeczywistym. Obsługuje scenariusze, które wymagają najnowszych wyników wyszukiwania.
klucz interfejsu API Połączenia z kluczami interfejsu API obsługują uwierzytelnianie dla każdego z osobna do określonego celu.
Klucz niestandardowy Połączenia niestandardowe umożliwiają bezpieczne przechowywanie kluczy dostępu i przechowywanie powiązanych właściwości, takich jak obiekty docelowe i wersje. Połączenia niestandardowe są przydatne, gdy masz wiele obiektów docelowych lub przypadków, w których nie potrzebujesz poświadczeń dostępu. Scenariusze LangChain to dobry przykład użycia niestandardowych połączeń usług. Połączenia niestandardowe nie zarządzają uwierzytelnianiem, więc musisz zarządzać uwierzytelnianiem samodzielnie.
Korzystanie z wyszukiwarki Bing Łączy się z wyszukiwaniem Bing, aby zapewnić uziemienie w internecie w czasie rzeczywistym dla zapytań. Umożliwia agentom sztucznej inteligencji odwoływania się do bieżących danych internetowych w odpowiedziach.
Model bezserwerowy Połączenia modelu bezserwerowego umożliwiają wdrażanie bezserwerowego interfejsu API. Tworzenie połączenia jest obsługiwane tylko za pośrednictwem kodu.
Azure Databricks Łącznik usługi Azure Databricks umożliwia łączenie agentów usługi Foundry z usługą Azure Databricks w celu uzyskiwania dostępu do przepływów pracy i funkcji Genie Spaces podczas wykonywania. Tworzenie połączenia jest obsługiwane tylko za pośrednictwem kodu.
Sharepoint Sharepoint to platforma firmy Microsoft do przechowywania i współpracy dokumentów. Umożliwia agentom dostęp do dokumentów organizacji i zarządzanie nimi. Tworzenie połączenia jest obsługiwane tylko za pośrednictwem kodu.
Microsoft Fabric Umiejętności sztucznej inteligencji umożliwiają tworzenie własnych konwersacyjnych systemów typu Q&A na Fabric przy użyciu generatywnej sztucznej inteligencji. Tworzenie połączenia jest obsługiwane tylko za pośrednictwem kodu.
Podstawy z użyciem wyszukiwania niestandardowego Bing Integruje się z niestandardowym wystąpieniem wyszukiwania Bing na potrzeby dostosowanego przeszukiwania Internetu. Tworzenie połączenia jest obsługiwane tylko za pośrednictwem kodu.
Azure APIM Usługa APIM umożliwia zarządzanie modelami sztucznej inteligencji wywoływanymi w usłudze Agent usługi Foundry. Tworzenie połączenia jest obsługiwane tylko za pośrednictwem kodu.
Brama modelu Usługa Model Gateway umożliwia zarządzanie modelami sztucznej inteligencji wywoływanymi w usłudze Agent usługi Foundry. Tworzenie połączenia jest obsługiwane tylko za pośrednictwem kodu.
Typ połączenia z usługą Preview Description
Wyszukiwanie AI platformy Azure Azure AI Search to zasób platformy Azure, który obsługuje pobieranie informacji za pośrednictwem wektora i danych tekstowych przechowywanych w indeksach wyszukiwania. Wymagany jest do wdrożenia Agenta Standardowego.
Azure Storage Azure Storage to rozwiązanie magazynu w chmurze do przechowywania danych bez struktury, takich jak dokumenty, obrazy, filmy wideo i instalatory aplikacji. Wymagany jest do wdrożenia Agenta Standardowego.
Azure Cosmos DB Azure Cosmos DB to globalnie rozproszona, wielomodelowa usługa bazy danych, która oferuje małe opóźnienia, wysoką dostępność i skalowalność w wielu regionach geograficznych. Wymagany jest do wdrożenia Agenta Standardowego. Tworzenie połączenia nie jest obsługiwane w centrum zarządzania usługi Foundry.
Azure OpenAI Azure OpenAI to usługa, która zapewnia dostęp do modeli OpenAI, w tym GPT-5, GPT-4o, DALLE-3 oraz serii modeli Embeddings, z zabezpieczeniami i możliwościami dla przedsiębiorstw, które oferuje platforma Azure.
Application Insights Azure Application Insights to usługa, która umożliwia deweloperom automatyczne wykrywanie anomalii wydajności, diagnozowanie problemów i uzyskiwanie szczegółowych informacji o użyciu i zachowaniu aplikacji.
Azure Key Vault Usługa platformy Azure do bezpiecznego przechowywania i uzyskiwania dostępu do wpisów tajnych. (Zobacz ograniczenia poniżej)
Odlewnia Połącz się z innymi zasobami rozwiązania Foundry.
OpenAI Nawiąż połączenie z modelami OpenAI.
Serp SERP łączy się ze stronami wyników wyszukiwarki w celu uzyskania dostępu do danych w czasie rzeczywistym. Obsługuje scenariusze, które wymagają najnowszych wyników wyszukiwania.
klucz interfejsu API Połączenia z kluczami interfejsu API obsługują uwierzytelnianie dla każdego z osobna do określonego celu.
Klucz niestandardowy Połączenia niestandardowe umożliwiają bezpieczne przechowywanie kluczy dostępu i przechowywanie powiązanych właściwości, takich jak obiekty docelowe i wersje. Połączenia niestandardowe są przydatne, gdy masz wiele obiektów docelowych lub przypadków, w których nie potrzebujesz poświadczeń dostępu. Scenariusze LangChain to dobry przykład użycia niestandardowych połączeń usług. Połączenia niestandardowe nie zarządzają uwierzytelnianiem, więc musisz zarządzać uwierzytelnianiem samodzielnie.
Korzystanie z wyszukiwarki Bing Łączy się z wyszukiwaniem Bing, aby zapewnić uziemienie w internecie w czasie rzeczywistym dla zapytań. Umożliwia agentom sztucznej inteligencji odwoływania się do bieżących danych internetowych w odpowiedziach.
Model bezserwerowy Połączenia modelu bezserwerowego umożliwiają wdrażanie bezserwerowego interfejsu API.
Azure Databricks Łącznik usługi Azure Databricks umożliwia łączenie agentów usługi Foundry z usługą Azure Databricks w celu uzyskiwania dostępu do przepływów pracy i funkcji Genie Spaces podczas wykonywania.
Sharepoint Sharepoint to platforma firmy Microsoft do przechowywania i współpracy dokumentów. Umożliwia agentom dostęp do dokumentów organizacji i zarządzanie nimi.
Microsoft Fabric Umiejętności sztucznej inteligencji umożliwiają tworzenie własnych konwersacyjnych systemów typu Q&A na Fabric przy użyciu generatywnej sztucznej inteligencji.
Podstawy z użyciem wyszukiwania niestandardowego Bing Integruje się z niestandardowym wystąpieniem wyszukiwania Bing na potrzeby dostosowanego przeszukiwania Internetu.

Ograniczenia usługi Azure Key Vault

Program Foundry przechowuje szczegóły połączeń w zarządzanej usłudze Azure Key Vault, jeśli nie utworzono połączenia z usługą Key Vault. Użytkownicy, którzy wolą zarządzać swoimi wpisami tajnymi, mogą korzystać z własnej usługi Azure Key Vault za pośrednictwem połączenia. Wszystkie projekty foundry używają zarządzanej usługi Azure Key Vault (nie pokazano jej w subskrypcji). Jeśli korzystasz z własnego Azure Key Vault, pamiętaj:

  • Tylko jedno połączenie Azure Key Vault może być używane na raz na zasób Foundry.
  • Połączenie usługi Azure Key Vault można usunąć tylko wtedy, gdy nie ma żadnych innych istniejących połączeń na poziomie zasobu lub projektu foundry.
  • Migracja wpisów tajnych nie jest obsługiwana; utwórz ponownie połączenia po dołączeniu usługi Key Vault.
  • Usunięcie podstawowego Azure Key Vault skutkuje awarią zasobu Foundry (połączenia zależą od przechowywanych tajemnic).
  • Usunięcie wpisów tajnych w usłudze BYO Key Vault może spowodować przerwanie połączeń z innymi usługami.

Ograniczenia połączenia usługi Azure Databricks (wersja zapoznawcza)

Obsługuje trzy typy połączeń — Zadania, Genie i Inne. Podczas konfigurowania połączenia w interfejsie użytkownika Foundry możesz wybrać przestrzeń Job lub Genie, którą chcesz powiązać z tym połączeniem. Możesz również użyć innego typu połączenia i zezwolić agentowi na dostęp do operacji obszaru roboczego w usłudze Azure Databricks. Uwierzytelnianie jest obsługiwane za pośrednictwem identyfikatora Entra firmy Microsoft dla użytkowników lub jednostek usługi. Przykłady użycia tego łącznika można znaleźć w temacie Zadania i Genie. Uwaga: Użycie tego połączenia jest możliwe tylko za pośrednictwem Foundry SDK w kodzie i jest zintegrowane jako FunctionTool z agentami (zobacz przykłady powyżej, aby uzyskać szczegółowe informacje). Użycie tego połączenia w narzędziu Foundry Playground nie jest obecnie obsługiwane.

Utwórz nowe połączenie

Użyj portalu lub szablonu Bicep, aby dodać połączenie.

Wykonaj następujące kroki, aby utworzyć nowe połączenie dostępne dla bieżącego projektu.

Tip

Ponieważ możesz dostosować okienko po lewej stronie w portalu Microsoft Foundry, możesz zobaczyć inne elementy, niż pokazano w tych krokach. Jeśli nie widzisz szukanych danych, wybierz pozycję ... Więcej w dolnej części okienka po lewej stronie.

  1. Zaloguj się do usługi Microsoft Foundry. Upewnij się, że przełącznik New Foundry jest wyłączony. Te kroki odnoszą się do rozwiązania Foundry (wersja klasyczna).

    Zaloguj się do usługi Microsoft Foundry. Upewnij się, że przełącznik New Foundry jest włączony. Te kroki dotyczą rozwiązania Foundry (nowy).

  2. Wybierz pozycję Centrum zarządzania w lewym dolnym rogu nawigacji.

  3. W sekcji Project (Projekt) wybierz pozycję Połączone zasoby.

  4. Wybierz pozycję + Nowe połączenie w sekcji Połączone zasoby .

    Zrzut ekranu przedstawiający przycisk dodawania nowego połączenia.

  5. Wybierz usługę, z którą chcesz nawiązać połączenie, z listy dostępnych zasobów zewnętrznych. Na przykład wybierz pozycję Azure AI Search.

    Zrzut ekranu przedstawiający stronę, aby wybrać usługę Azure AI Search z listy innych zasobów.

  6. Wyszukaj i wybierz usługę Azure AI Search z listy dostępnych usług, a następnie wybierz typ uwierzytelniania, którego chcesz użyć dla zasobu. Wybierz opcję Dodaj połączenie.

    Tip

    Różne typy połączeń obsługują różne metody uwierzytelniania. Korzystanie z identyfikatora Entra firmy Microsoft może wymagać określonych uprawnień dostępu opartych na rolach platformy Azure dla deweloperów. Aby uzyskać więcej informacji, odwiedź stronę Kontrola dostępu oparta na rolach.

    Zrzut ekranu strony, na której można wybrać usługę Azure AI Search, do której chcesz się połączyć.

  7. Po nawiązaniu połączenia z usługą wybierz pozycję Zamknij.

  1. Zaloguj się do usługi Microsoft Foundry. Upewnij się, że przełącznik New Foundry jest wyłączony. Te kroki odnoszą się do rozwiązania Foundry (wersja klasyczna).

    Zaloguj się do usługi Microsoft Foundry. Upewnij się, że przełącznik New Foundry jest włączony. Te kroki dotyczą rozwiązania Foundry (nowy).

  2. Wybierz pozycję Operuj w prawym górnym rogu nawigacji.

  3. Wybierz pozycję Administrator w okienku po lewej stronie.

  4. Wybierz nazwę projektu na liście Zarządzaj wszystkimi projektami .

  5. Wybierz pozycję Dodaj połączenie w prawym górnym rogu.

  6. Wybierz usługę, z którą chcesz nawiązać połączenie, z listy dostępnych zasobów zewnętrznych. Na przykład wybierz pozycję Azure AI Search.

  7. Wyszukaj i wybierz usługę Azure AI Search z listy dostępnych usług, a następnie wybierz typ uwierzytelniania, którego chcesz użyć dla zasobu. Wybierz opcję Dodaj połączenie.

    Tip

    Różne typy połączeń obsługują różne metody uwierzytelniania. Korzystanie z identyfikatora Entra firmy Microsoft może wymagać określonych uprawnień dostępu opartych na rolach platformy Azure dla deweloperów. Aby uzyskać więcej informacji, odwiedź stronę Kontrola dostępu oparta na rolach.

Izolacja sieci

Aby zapewnić kompleksową izolację sieci za pomocą rozwiązania Foundry, potrzebujesz prywatnych punktów końcowych, aby połączyć się z połączonym zasobem. Jeśli na przykład konto usługi Azure Storage jest ustawione na dostęp do sieci publicznej jako Wyłączone, prywatny punkt końcowy powinien zostać wdrożony w sieci wirtualnej w celu uzyskania dostępu do usługi Foundry.

Aby uzyskać więcej informacji na temat ustawiania prywatnych punktów końcowych na połączone zasoby, zobacz następującą dokumentację:

Zasób prywatny Documentation
Azure Storage Korzystanie z prywatnych punktów końcowych
Azure Cosmos DB Konfigurowanie usługi Azure Private Link dla usługi Azure Cosmos DB
Wyszukiwanie AI platformy Azure Tworzenie prywatnego punktu końcowego na potrzeby bezpiecznego połączenia
Azure OpenAI Zabezpieczanie usługi Azure OpenAI w sieci wirtualnej przy użyciu prywatnych punktów końcowych
Application Insights Używanie usługi Azure Private Link do łączenia sieci z usługą Azure Monitor

Uwaga / Notatka

Połączenia między subskrypcjami używane na potrzeby wdrażania modelu nie są obsługiwane (Foundry, Azure OpenAI). Nie można nawiązać połączenia z zasobami z różnych subskrypcji dla wdrożeń modelu.