Yardi Virtuoso (wersja zapoznawcza)

Ten łącznik jest dostępny w następujących produktach i regionach:

Łącznik Yardi Virtuoso

Yardi Virtuoso zapewnia bezpieczny, w czasie rzeczywistym dostęp do danych i narzędzi Yardi za pośrednictwem Microsoft Copilot. Umożliwia ona specjalistom zajmującym się inwestycjami, nieruchomościami i zasobami wykonywanie zapytań dotyczących modeli finansowych, analizy predykcyjnej konserwacji, analizy rynku i danych portfela przy użyciu języka naturalnego. Użytkownicy mogą zadawać złożone pytania operacyjne, eksplorować scenariusze strategiczne i przeprowadzać analizę bez ręcznego wyodrębniania danych, a wszystkie uziemione w dokładnych danych stoczni klasy korporacyjnej.

Łącznik jest implementacją protokołu MCP (Model Context Protocol), otwartego standardu łączenia asystentów sztucznej inteligencji z systemami zewnętrznymi, takimi jak narzędzia biznesowe, repozytoria danych i środowiska programistyczne. Zamiast uwidaczniać stały zestaw operacji REST, łącznik mówi MCP za pośrednictwem przesyłanego strumieniowo protokołu HTTP, więc serwer Yardi Virtuoso MCP anonsuje własne narzędzia i zasoby do agenta wywołującego w czasie wykonywania. Oznacza to, że nowe możliwości stoczni stają się dostępne dla agentów bez ponownego publikowania łącznika.

Prerequisites

Aby kontynuować, musisz wykonać następujące czynności:

• Plan usługi Microsoft Power Apps lub Power Automate z funkcją łącznika niestandardowego
• Licencja Microsoft Copilot Studio dla agentów korzystających z serwera MCP
• Licencjonowana subskrypcja Yardi Virtuoso
• Konto YardiOne z dostępem do danych i narzędzi Stocznii, które zamierzasz wykonywać zapytania
• Narzędzia interfejsu wiersza polecenia platformy Power Platform (paconn), jeśli wdrażasz ze źródła zamiast importować rozwiązanie zarządzane

Kompilowanie łącznika

Serwer Yardi Virtuoso MCP jest zabezpieczony przez YardiOne, który działa jako serwer autoryzacji OAuth 2.0. Uwierzytelnianie używa protokołu OAuth 2.0 z metadanymi PKCE i chronionymi zasobami (oauth2pkcewithprm), dlatego łącznik odnajduje serwer autoryzacji i rejestruje się dynamicznie zamiast polegać na wstępnie aprowizacji identyfikatora klienta i wpisu tajnego.

Ze względu na ten przepływ odnajdywania nie ma Entra ID kroku rejestracji aplikacji i nie ma wpisu tajnego klienta do zarządzania. Łącznik deklaruje adres serwera MCP, a platforma Power Platform obsługuje resztę uzgadniania:

1. Łącznik anonsuje chroniony zasób , https://mcp.virtuoso.ai/mcpza pośrednictwem parametru ServerUrl połączenia.
2. Na pierwszym połączeniu platforma Power Platform pobiera metadane chronionego zasobu z serwera MCP, który wskazuje na serwer autoryzacji YardiOne.
3. Łącznik rejestruje się dynamicznie za pomocą aplikacji YardiOne i przekierowuje użytkownika w celu zalogowania się.
4. YardiOne wystawia token dostępu w zakresie tego użytkownika, a łącznik dołącza go jako token elementu nośnego w każdym żądaniu MCP.

W związku z tym dostęp jest oceniany dla poszczególnych użytkowników względem swoich uprawnień YardiOne. Agent może uzyskać dostęp tylko do danych stoczni i narzędzi, które zalogowany użytkownik może już zobaczyć, a każde wywołanie narzędzia można przeprowadzić inspekcję z powrotem do tej tożsamości.

Adres URL przekierowania skonfigurowany dla tego łącznika to:

https://global.consent.azure-apim.net/redirect/cre88-5fvirt-5fprod-5fdyn-5foauth-5fdisc-5f985796682d33968b

Jest GlobalPerConnector to przekierowanie, dlatego jest specyficzne dla tej rejestracji łącznika i musi być na liście dozwolonych przez serwer autoryzacji YardiOne.

Wdrażanie łącznika

Zaimportuj rozwiązanie zarządzane uwzględnione w tym pakiecie:

pac solution import --path YardiVirtuosoConnector_1_0_0_2_managed.zip

Rozwiązanie pakuje tylko składnik łącznika niestandardowego. Nie zawiera żadnych dodatkowych tabel, przepływów pracy ani ról zabezpieczeń.

Alternatywnie w celu wdrożenia z definicji łącznika w tym repozytorium:

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json

Obsługiwane operacje

Łącznik uwidacznia jedną operację platformy Power Platform, która przenosi protokół MCP:

• Yardi Virtuoso (InvokeServer): Wywołuje serwer Yardi Virtuoso MCP za pośrednictwem strumieniowego protokołu HTTP. Jest to transport dla całego ruchu MCP, w tym odnajdywania narzędzi i wywołania narzędzi.

Agenci nie nazywają tej operacji bezpośrednio. Po autoryzowanym połączeniu Copilot Studio wystawia żądanie MCPtools/list, a serwer Yardi Virtuoso zwraca narzędzia dostępne dla zalogowanego użytkownika. Następnie agent wywołuje te narzędzia według nazwy. Ponieważ katalog narzędzi jest obsługiwany przez Yardi Virtuoso, a nie zadeklarowany w definicji interfejsu OpenAPI łącznika, może zmienić się po stronie serwera bez aktualizacji łącznika.

Znane problemy i ograniczenia

• Łącznik używa mcp-streamable-1.0 protokołu agenta i jest przeznaczony do użycia w agentach Microsoft Copilot Studio. Nie jest przeznaczony do użycia jako konwencjonalne działanie w przepływach Power Automate lub Power Apps.
• Katalog narzędzi jest rozpoznawany w czasie wykonywania z serwera Yardi Virtuoso MCP, więc operacje dostępne dla agenta zależą od wersji serwera i uprawnień zalogowanego użytkownika YardiOne.
• Każde połączenie jest powiązane z indywidualnym użytkownikiem YardiOne. Logowanie w imieniu nie jest obsługiwane, więc połączenia nie mogą być współużytkowane przez użytkowników.
• Wymagany jest dostęp wychodzący do mcp.virtuoso.ai za pośrednictwem protokołu HTTPS. Środowiska ograniczające ruch wychodzący muszą zezwalać na tagi usługi Azure używane przez platformę Power Platform w odpowiednim regionie.

Akcje

Yardi Virtuoso