Yardi Virtuoso (Vorschau)

Yardi Virtuoso bietet sicheren Echtzeitzugriff auf Yardi-Daten und -Tools über Co-Pilot. Es ermöglicht Investment-, Immobilien- und Vermögensverwaltungsexperten Finanzmodelle, predictive Maintenance Insights, Marktanalyse und Portfoliodaten mithilfe natürlicher Sprache abzufragen. Benutzer können komplexe betriebliche Fragen stellen, strategische Szenarien untersuchen und Analysen ohne manuelle Datenextraktion durchführen, die alle in genauen, auf Unternehmensniveau befindlichen Yardi-Daten geerdet werden.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Service Class Regions
Copilot Studio Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Standard Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure Government Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Yardi Systems, Inc.
URL https://www.yardi.com
E‑Mail support@yardi.com
Connectormetadaten
Herausgeber Yardi Systems LLC
Yardi Virtuoso MCP Technische Dokumentationsanleitung https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide
Website https://www.yardi.com
Datenschutzrichtlinie https://resources.yardi.com/legal/privacy-statement/
Categories Künstliche Intelligenz; Unternehmensführung
Documentation https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide
Support https://www.yardi.com/company/technical-support/

Yardi Virtuoso Connector

Yardi Virtuoso bietet sicheren Echtzeitzugriff auf Yardi-Daten und -Tools über Microsoft Copilot. Es ermöglicht Investment-, Immobilien- und Vermögensverwaltungsexperten Finanzmodelle, predictive Maintenance Insights, Marktanalyse und Portfoliodaten mithilfe natürlicher Sprache abzufragen. Benutzer können komplexe betriebliche Fragen stellen, strategische Szenarien untersuchen und Analysen ohne manuelle Datenextraktion durchführen, die alle in genauen, auf Unternehmensniveau befindlichen Yardi-Daten geerdet werden.

Der Connector ist eine Implementierung des Model Context Protocol (MCP), eines offenen Standards zum Verbinden von KI-Assistenten mit externen Systemen wie Geschäftstools, Datenrepositorys und Entwicklungsumgebungen. Anstatt eine feste Gruppe von REST-Vorgängen verfügbar zu machen, spricht der Connector MCP über streambares HTTP, sodass der Yardi Virtuoso MCP-Server seine eigenen Tools und Ressourcen für den aufrufenden Agent zur Laufzeit ankündigen. Dies bedeutet, dass neue Yardi-Funktionen für Agents verfügbar werden, ohne den Connector erneut zu veröffentlichen.

Prerequisites

Sie benötigen Folgendes, um fortzufahren:

  • Ein Microsoft Power Apps- oder Power Automate-Plan mit dem benutzerdefinierten Connectorfeature
  • Eine Microsoft Copilot Studio-Lizenz für Agents, die den MCP-Server nutzen
  • Ein lizenziertes Yardi Virtuoso-Abonnement
  • Ein YardiOne-Konto mit Zugriff auf die Yardi-Daten und -Tools, die Sie abfragen möchten
  • Die Power Platform CLI-Tools (paconn), wenn Sie die verwaltete Lösung nicht aus der Quelle importieren, sondern aus der Quelle bereitstellen

Erstellen des Verbinders

Der Yardi Virtuoso MCP-Server wird von YardiOne gesichert, der als OAuth 2.0-Autorisierungsserver fungiert. Die Authentifizierung verwendet OAuth 2.0 mit PKCE und geschützten Ressourcenmetadaten (oauth2pkcewithprm), sodass der Connector den Autorisierungsserver erkennt und sich dynamisch registriert, anstatt auf eine zuvor bereitgestellte Client-ID und einen geheimen Schlüssel zu vertrauen.

Aufgrund dieses Ermittlungsflusses gibt es keinen Entra ID App-Registrierungsschritt und keinen geheimen Clientschlüssel für die Verwaltung. Der Connector deklariert die MCP-Serveradresse und Power Platform behandelt den Rest des Handshake:

  1. Der Connector kündigt seine geschützte Ressource über https://mcp.virtuoso.ai/mcpden ServerUrl Verbindungsparameter an.
  2. Bei der ersten Verbindung ruft Power Platform die geschützten Ressourcenmetadaten vom MCP-Server ab, der auf den YardiOne-Autorisierungsserver verweist.
  3. Der Connector registriert sich dynamisch bei YardiOne und leitet den Benutzer zur Anmeldung um.
  4. YardiOne gibt ein Zugriffstoken für diesen Benutzer aus, und der Connector fügt es als Bearertoken für jede MCP-Anforderung an.

Der Zugriff wird daher pro Benutzer anhand ihrer YardiOne-Berechtigungen ausgewertet. Ein Agent kann nur die Yardi-Daten und -Tools erreichen, die der angemeldete Benutzer bereits sehen darf, und jeder Toolaufruf kann auf diese Identität zurückgeprüft werden.

Die für diesen Connector konfigurierte Umleitungs-URL lautet:

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

Dies ist eine GlobalPerConnector Umleitung, sodass sie für diese Connectorregistrierung spezifisch ist und vom YardiOne-Autorisierungsserver zugelassen werden muss.

Bereitstellen des Connectors

Importieren Sie die verwaltete Lösung, die in diesem Paket enthalten ist:

pac solution import --path YardiVirtuosoConnector_1_0_0_2_managed.zip

Die Lösung enthält nur die benutzerdefinierte Connectorkomponente. Sie enthält keine zusätzlichen Tabellen, Workflows oder Sicherheitsrollen.

Property Wert
Eindeutiger Name der Lösung YardiVirtuosoConnector
Lösungsversion 1.0.0.2 (verwaltet)
Herausgeber Yardi_Virtuoso_developer (Präfix virtuoso)
Interner Connectorname cre88_5Fvirt-5Fprod-5Fdyn-5Foauth-5Fdisc
Host mcp.virtuoso.ai
MCP-Endpunkt POST /mcp
Agentic-Protokoll mcp-streamable-1.0

Alternativ können Sie die Connectordefinition in diesem Repository bereitstellen:

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

Unterstützte Vorgänge

Der Connector macht einen einzelnen Power Platform-Vorgang verfügbar, der das MCP-Protokoll trägt:

  • Yardi Virtuoso (InvokeServer): Ruft den Yardi Virtuoso MCP-Server über streambare HTTP auf. Dies ist der Transport für den gesamten MCP-Datenverkehr, einschließlich Toolermittlung und Toolaufruf.

Agents rufen diesen Vorgang nicht direkt auf. Sobald eine Verbindung autorisiert ist, gibt Copilot Studio eine MCP-Anforderung tools/list aus, und der Yardi Virtuoso-Server gibt die tools zurück, die dem angemeldeten Benutzer zur Verfügung stehen. Der Agent ruft diese Tools dann anhand des Namens auf. Da der Toolkatalog von Yardi Virtuoso bereitgestellt wird, anstatt in der OpenAPI-Definition des Connectors deklariert zu werden, kann er sich auf der Serverseite ohne Connectoraktualisierung ändern.

Bekannte Probleme und Einschränkungen

  • Der Connector verwendet das mcp-streamable-1.0 agentische Protokoll und ist für die Verwendung in Microsoft Copilot Studio Agents vorgesehen. Es ist nicht für die Verwendung als konventionelle Aktion in Power Automate Flüssen oder Power Apps konzipiert.
  • Der Toolkatalog wird zur Laufzeit vom Yardi Virtuoso MCP-Server aufgelöst, sodass die für einen Agent verfügbaren Vorgänge von der Serverversion und den YardiOne-Berechtigungen des angemeldeten Benutzers abhängen.
  • Jede Verbindung ist an einen einzelnen YardiOne-Benutzer gebunden. Die Anmeldung im Auftrag des Benutzers wird nicht unterstützt, sodass Verbindungen nicht für alle Benutzer freigegeben werden können.
  • Ausgehender Zugriff auf mcp.virtuoso.ai HTTPS ist erforderlich. Umgebungen, die den Ausgang einschränken, müssen die von Power Platform in der relevanten Region verwendeten Azure Diensttags zulassen.

Aktionen

Yardi Virtuoso

Yardi Virtuoso bietet sicheren Echtzeitzugriff auf Yardi-Daten und -Tools über Co-Pilot. Es ermöglicht Investment-, Immobilien- und Vermögensverwaltungsexperten Finanzmodelle, predictive Maintenance Insights, Marktanalyse und Portfoliodaten mithilfe natürlicher Sprache abzufragen. Benutzer können komplexe betriebliche Fragen stellen, strategische Szenarien untersuchen und Analysen ohne manuelle Datenextraktion durchführen, die alle in genauen, auf Unternehmensniveau befindlichen Yardi-Daten geerdet werden.

Yardi Virtuoso

Yardi Virtuoso bietet sicheren Echtzeitzugriff auf Yardi-Daten und -Tools über Co-Pilot. Es ermöglicht Investment-, Immobilien- und Vermögensverwaltungsexperten Finanzmodelle, predictive Maintenance Insights, Marktanalyse und Portfoliodaten mithilfe natürlicher Sprache abzufragen. Benutzer können komplexe betriebliche Fragen stellen, strategische Szenarien untersuchen und Analysen ohne manuelle Datenextraktion durchführen, die alle in genauen, auf Unternehmensniveau befindlichen Yardi-Daten geerdet werden.