Yardi Virtuoso (preview)

Yardi Virtuoso biedt veilige, realtime toegang tot Yardi-gegevens en -hulpprogramma's via Co-Pilot. Het stelt beleggings-, vastgoed- en assetbeheerprofessionals in staat om financiële modellen, voorspellende onderhoudsinzichten, marktanalyse en portfoliogegevens te doorzoeken met behulp van natuurlijke taal. Gebruikers kunnen complexe operationele vragen stellen, strategische scenario's verkennen en analyses uitvoeren zonder handmatige gegevensextractie, allemaal geaard in nauwkeurige Yardi-gegevens op bedrijfsniveau.

Deze connector is beschikbaar in de volgende producten en regio's:

Service Class Regions
Copilot Studio Premium Alle Power Automate regio's behalve:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logische apps Standard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps regio's behalve:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate regio's behalve:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contact
Name Yardi Systems, Inc.
URL https://www.yardi.com
E-mailadres support@yardi.com
Connectormetagegevens
Publisher Yardi Systems LLC
Technische documentatiehandleiding yardi Virtuoso MCP https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide
Website https://www.yardi.com
Privacybeleid https://resources.yardi.com/legal/privacy-statement/
Categories AI; Bedrijfsbeheer
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 biedt veilige, realtime toegang tot Yardi-gegevens en -hulpprogramma's via Microsoft Copilot. Het stelt beleggings-, vastgoed- en assetbeheerprofessionals in staat om financiële modellen, voorspellende onderhoudsinzichten, marktanalyse en portfoliogegevens te doorzoeken met behulp van natuurlijke taal. Gebruikers kunnen complexe operationele vragen stellen, strategische scenario's verkennen en analyses uitvoeren zonder handmatige gegevensextractie, allemaal geaard in nauwkeurige Yardi-gegevens op bedrijfsniveau.

De connector is een implementatie van het Model Context Protocol (MCP), een open standaard voor het verbinden van AI-assistenten met externe systemen, zoals bedrijfshulpprogramma's, gegevensopslagplaatsen en ontwikkelomgevingen. In plaats van een vaste set REST-bewerkingen weer te geven, spreekt de connector MCP via streambare HTTP, dus de Yardi Virtuoso MCP-server kondigt zijn eigen hulpprogramma's en resources aan de aanroepende agent tijdens runtime aan. Dit betekent dat er nieuwe Yardi-mogelijkheden beschikbaar worden voor agents zonder de connector opnieuw te publiceren.

Prerequisites

U hebt het volgende nodig om door te gaan:

  • Een Microsoft Power Apps- of Power Automate-abonnement met de aangepaste connectorfunctie
  • Een Microsoft Copilot Studio-licentie voor agents die de MCP-server gebruiken
  • Een gelicentieerd Yardi Virtuoso-abonnement
  • Een YardiOne-account met toegang tot de Yardi-gegevens en -hulpprogramma's die u wilt opvragen
  • De Cli-hulpprogramma's van Power Platform (paconn) als u implementeert vanuit de bron in plaats van de beheerde oplossing te importeren

De connector bouwen

De Yardi Virtuoso MCP-server wordt beveiligd door YardiOne, die fungeert als de OAuth 2.0-autorisatieserver. Verificatie maakt gebruik van OAuth 2.0 met PKCE- en beveiligde bronmetagegevens (oauth2pkcewithprm), zodat de connector de autorisatieserver detecteert en zichzelf dynamisch registreert in plaats van te vertrouwen op een vooraf ingerichte client-id en -geheim.

Vanwege deze detectiestroom is er geen Entra ID app-registratiestap en geen clientgeheim dat moet worden beheerd. De connector declareert het MCP-serveradres en Power Platform verwerkt de rest van de handshake:

  1. De connector adverteert de beveiligde resource, https://mcp.virtuoso.ai/mcpvia de ServerUrl verbindingsparameter.
  2. Bij de eerste verbinding haalt Power Platform de beveiligde bronmetagegevens op van de MCP-server, die verwijst naar de YardiOne-autorisatieserver.
  3. De connector wordt dynamisch geregistreerd bij YardiOne en stuurt de gebruiker om zich aan te melden.
  4. YardiOne geeft een toegangstoken op dat aan die gebruiker is gericht en de connector koppelt het als bearer-token op elke MCP-aanvraag.

Toegang wordt daarom per gebruiker geëvalueerd op basis van hun YardiOne-rechten. Een agent kan alleen de Yardi-gegevens en -hulpprogramma's bereiken die de aangemelde gebruiker al mag zien en elke aanroep kan worden gecontroleerd op die identiteit.

De omleidings-URL die voor deze connector is geconfigureerd, is:

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

Dit is een GlobalPerConnector omleiding, dus dit is specifiek voor deze connectorregistratie en moet worden toegestaan door de YardiOne-autorisatieserver.

De connector implementeren

Importeer de beheerde oplossing die is opgenomen in dit pakket:

pac solution import --path YardiVirtuosoConnector_1_0_0_2_managed.zip

De oplossing verpakt alleen het aangepaste connectoronderdeel. Het bevat geen extra tabellen, werkstromen of beveiligingsrollen.

Property Value
Unieke naam van oplossing YardiVirtuosoConnector
Oplossingsversie 1.0.0.2 (beheerd)
Publisher Yardi_Virtuoso_developer (voorvoegsel virtuoso)
Interne naam van connector cre88_5Fvirt-5Fprod-5Fdyn-5Foauth-5Fdisc
Host mcp.virtuoso.ai
MCP-eindpunt POST /mcp
Agentisch protocol mcp-streamable-1.0

U kunt ook implementeren vanuit de definitie van de connector in deze opslagplaats:

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

Ondersteunde bewerkingen

De connector maakt één Power Platform-bewerking beschikbaar, die het MCP-protocol bevat:

  • Yardi Virtuoso (InvokeServer): Roept de Yardi Virtuoso MCP-server aan via streambare HTTP. Dit is het transport voor alle MCP-verkeer, inclusief detectie van hulpprogramma's en aanroepen van hulpprogramma's.

Agents roepen die bewerking niet rechtstreeks aan. Zodra een verbinding is geautoriseerd, geeft Copilot Studio een MCP-aanvraag tools/list uit en retourneert de Yardi Virtuoso-server de hulpprogramma's die beschikbaar zijn voor de aangemelde gebruiker. De agent roept deze hulpprogramma's vervolgens op naam aan. Omdat de hulpprogrammacatalogus wordt geleverd door Yardi Virtuoso in plaats van gedeclareerd in de OpenAPI-definitie van de connector, kan deze worden gewijzigd aan de serverzijde zonder een connectorupdate.

Bekende problemen en beperkingen

  • De connector maakt gebruik van het mcp-streamable-1.0 agentische protocol en is bedoeld voor gebruik in Microsoft Copilot Studio agents. Het is niet ontworpen voor gebruik als een conventionele actie in Power Automate stromen of Power Apps.
  • De hulpprogrammacatalogus wordt tijdens runtime opgelost vanaf de Yardi Virtuoso MCP-server, dus de bewerkingen die beschikbaar zijn voor een agent, zijn afhankelijk van de serverversie en van de rechten van de aangemelde gebruiker YardiOne.
  • Elke verbinding is gebonden aan een afzonderlijke YardiOne-gebruiker. Aanmelding namens wordt niet ondersteund, zodat verbindingen niet kunnen worden gedeeld tussen gebruikers.
  • Uitgaande toegang tot mcp.virtuoso.ai via HTTPS is vereist. Omgevingen die uitgaand verkeer beperken, moeten de Azure servicetags die door Power Platform in de relevante regio worden gebruikt, toestaan.

Acties

Yardi Virtuoso

Yardi Virtuoso biedt veilige, realtime toegang tot Yardi-gegevens en -hulpprogramma's via Co-Pilot. Het stelt beleggings-, vastgoed- en assetbeheerprofessionals in staat om financiële modellen, voorspellende onderhoudsinzichten, marktanalyse en portfoliogegevens te doorzoeken met behulp van natuurlijke taal. Gebruikers kunnen complexe operationele vragen stellen, strategische scenario's verkennen en analyses uitvoeren zonder handmatige gegevensextractie, allemaal geaard in nauwkeurige Yardi-gegevens op bedrijfsniveau.

Yardi Virtuoso

Yardi Virtuoso biedt veilige, realtime toegang tot Yardi-gegevens en -hulpprogramma's via Co-Pilot. Het stelt beleggings-, vastgoed- en assetbeheerprofessionals in staat om financiële modellen, voorspellende onderhoudsinzichten, marktanalyse en portfoliogegevens te doorzoeken met behulp van natuurlijke taal. Gebruikers kunnen complexe operationele vragen stellen, strategische scenario's verkennen en analyses uitvoeren zonder handmatige gegevensextractie, allemaal geaard in nauwkeurige Yardi-gegevens op bedrijfsniveau.