Yardi Virtuoso (förhandsversion)

Yardi Virtuoso ger säker realtidsåtkomst till Yardi-data och -verktyg via Co-Pilot. Det gör det möjligt för investerings-, fastighets- och tillgångshanteringspersonal att fråga efter finansiella modeller, insikter om förutsägande underhåll, marknadsanalys och portföljdata med naturligt språk. Användare kan ställa komplexa operativa frågor, utforska strategiska scenarier och utföra analyser utan manuell dataextrahering, allt baserat på korrekta Yardi-data i företagsklass.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Service Class Regioner
Copilot Studio Premium Alla Power Automate regioner förutom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Logiska appar Standard Alla Logic Apps-regioner utom följande:
     - Azure Government regioner
     - Azure kinaregioner
     - US Department of Defense (DoD)
Power Apps Premium Alla Power Apps regioner förutom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alla Power Automate regioner förutom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Yardi Systems, Inc.
URL https://www.yardi.com
E-postmeddelande support@yardi.com
Metadata för anslutningsprogram
Publisher Yardi Systems LLC
Teknisk dokumentationsguide för Yardi Virtuoso MCP https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide
Website https://www.yardi.com
Sekretesspolicy https://resources.yardi.com/legal/privacy-statement/
Categories Artificiell intelligens; Företagsledning
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 ger säker realtidsåtkomst till Yardi-data och -verktyg via Microsoft Copilot. Det gör det möjligt för investerings-, fastighets- och tillgångshanteringspersonal att fråga efter finansiella modeller, insikter om förutsägande underhåll, marknadsanalys och portföljdata med naturligt språk. Användare kan ställa komplexa operativa frågor, utforska strategiska scenarier och utföra analyser utan manuell dataextrahering, allt baserat på korrekta Yardi-data i företagsklass.

Anslutningsappen är en implementering av Model Context Protocol (MCP), en öppen standard för att ansluta AI-assistenter till externa system som affärsverktyg, datalagringsplatser och utvecklingsmiljöer. I stället för att exponera en fast uppsättning REST-åtgärder talar anslutningsappen MCP över strömmande HTTP, så Yardi Virtuoso MCP-servern annonserar sina egna verktyg och resurser till den anropande agenten vid körning. Det innebär att nya Yardi-funktioner blir tillgängliga för agenter utan att publicera om anslutningsappen.

Prerequisites

Du behöver följande för att fortsätta:

  • En Microsoft Power Apps- eller Power Automate-plan med den anpassade anslutningsfunktionen
  • En Microsoft Copilot Studio licens för agenter som använder MCP-servern
  • En licensierad Yardi Virtuoso-prenumeration
  • Ett YardiOne-konto med åtkomst till Yardi-data och verktyg som du tänker köra frågor mot
  • Power Platform CLI-verktygen (paconn), om du distribuerar från källan i stället för att importera den hanterade lösningen

Skapa anslutningsappen

Yardi Virtuoso MCP-servern skyddas av YardiOne, som fungerar som OAuth 2.0-auktoriseringsserver. Autentisering använder OAuth 2.0 med PKCE och metadata för skyddade resurser (oauth2pkcewithprm), så anslutningsappen identifierar auktoriseringsservern och registrerar sig dynamiskt i stället för att förlita sig på ett fördefinierat klient-ID och hemlighet.

På grund av identifieringsflödet finns det inget Entra ID appregistreringssteg och ingen klienthemlighet att hantera. Anslutningsappen deklarerar MCP-serveradressen och Power Platform hanterar resten av handskakningen:

  1. Anslutningsappen annonserar sin skyddade resurs, https://mcp.virtuoso.ai/mcp, via anslutningsparametern ServerUrl .
  2. Vid den första anslutningen hämtar Power Platform skyddade resursmetadata från MCP-servern, som pekar på YardiOne-auktoriseringsservern.
  3. Anslutningsappen registreras dynamiskt med YardiOne och omdirigerar användaren för att logga in.
  4. YardiOne utfärdar en åtkomsttoken som är begränsad till användaren och anslutningsappen bifogar den som en ägartoken för varje MCP-begäran.

Åtkomst utvärderas därför per användare mot deras YardiOne-rättigheter. En agent kan bara nå Yardi-data och verktyg som den inloggade användaren redan har behörighet att se, och varje verktygsanrop kan granskas tillbaka till den identiteten.

Omdirigerings-URL:en som konfigurerats för den här anslutningsappen är:

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

Det här är en GlobalPerConnector omdirigering, så den är specifik för den här anslutningsappsregistreringen och måste anges av YardiOne-auktoriseringsservern.

Distribuera anslutningsappen

Importera den hanterade lösningen som ingår i det här paketet:

pac solution import --path YardiVirtuosoConnector_1_0_0_2_managed.zip

Lösningen paketar endast komponenten för den anpassade anslutningsappen. Den innehåller inga ytterligare tabeller, arbetsflöden eller säkerhetsroller.

Property Value
Unikt namn på lösningen YardiVirtuosoConnector
Lösningsversion 1.0.0.2 (hanterad)
Publisher Yardi_Virtuoso_developer (prefix virtuoso)
Internt namn för anslutningsappen cre88_5Fvirt-5Fprod-5Fdyn-5Foauth-5Fdisc
Host mcp.virtuoso.ai
MCP-slutpunkt POST /mcp
Agentiskt protokoll mcp-streamable-1.0

Du kan också distribuera från anslutningsdefinitionen på den här lagringsplatsen:

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

Åtgärder som stöds

Anslutningsappen exponerar en enda Power Platform-åtgärd som bär MCP-protokollet:

  • Yardi Virtuoso (InvokeServer): Anropar Yardi Virtuoso MCP-servern via strömmande HTTP. Det här är transporten för all MCP-trafik, inklusive verktygsidentifiering och anrop av verktyg.

Agenter anropar inte åtgärden direkt. När en anslutning har auktoriserats utfärdar Copilot Studio en MCP-begäran tools/list och Yardi Virtuoso-servern returnerar de verktyg som är tillgängliga för den inloggade användaren. Agenten anropar sedan dessa verktyg med namn. Eftersom verktygskatalogen hanteras av Yardi Virtuoso i stället för att deklareras i anslutningsappens OpenAPI-definition kan den ändras på serversidan utan en anslutningsuppdatering.

Kända problem och begränsningar

  • Anslutningsappen använder agentprotokollet mcp-streamable-1.0 och är avsett att användas i Microsoft Copilot Studio agenter. Den är inte avsedd att användas som en konventionell åtgärd i Power Automate flöden eller Power Apps.
  • Verktygskatalogen löses vid körning från Yardi Virtuoso MCP-servern, så de åtgärder som är tillgängliga för en agent beror på serverversionen och den inloggade användarens YardiOne-rättigheter.
  • Varje anslutning är bunden till en enskild YardiOne-användare. Inloggningen stöds inte, så anslutningar kan inte delas mellan användare.
  • Utgående åtkomst till mcp.virtuoso.ai via HTTPS krävs. Miljöer som begränsar utgående trafik måste tillåta Azure tjänsttaggar som används av Power Platform i den relevanta regionen.

Åtgärder

Yardi Virtuoso

Yardi Virtuoso ger säker realtidsåtkomst till Yardi-data och -verktyg via Co-Pilot. Det gör det möjligt för investerings-, fastighets- och tillgångshanteringspersonal att fråga efter finansiella modeller, insikter om förutsägande underhåll, marknadsanalys och portföljdata med naturligt språk. Användare kan ställa komplexa operativa frågor, utforska strategiska scenarier och utföra analyser utan manuell dataextrahering, allt baserat på korrekta Yardi-data i företagsklass.

Yardi Virtuoso

Yardi Virtuoso ger säker realtidsåtkomst till Yardi-data och -verktyg via Co-Pilot. Det gör det möjligt för investerings-, fastighets- och tillgångshanteringspersonal att fråga efter finansiella modeller, insikter om förutsägande underhåll, marknadsanalys och portföljdata med naturligt språk. Användare kan ställa komplexa operativa frågor, utforska strategiska scenarier och utföra analyser utan manuell dataextrahering, allt baserat på korrekta Yardi-data i företagsklass.