Yardi Virtuoso (préversion)

Yardi Virtuoso offre un accès sécurisé et en temps réel aux données et outils Yardi par le biais du copilote. Il permet aux professionnels de l’investissement, de la propriété et de la gestion des actifs d’interroger des modèles financiers, des insights de maintenance prédictive, de l’analyse du marché et des données de portefeuille à l’aide du langage naturel. Les utilisateurs peuvent poser des questions opérationnelles complexes, explorer des scénarios stratégiques et effectuer une analyse sans extraction manuelle des données, toutes ancrées dans des données Yardi précises et de classe entreprise.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Name Yardi Systems, Inc.
URL https://www.yardi.com
Courriel support@yardi.com
Métadonnées du connecteur
Éditeur Yardi Systems LLC
Guide de documentation technique Yardi Virtuoso MCP https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide
Website https://www.yardi.com
Politique de confidentialité https://resources.yardi.com/legal/privacy-statement/
Categories IA; Gestion de l’entreprise
Documentation https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide
Support https://www.yardi.com/company/technical-support/

Connecteur Yardi Virtuoso

Yardi Virtuoso offre un accès sécurisé et en temps réel aux données et outils Yardi via Microsoft Copilot. Il permet aux professionnels de l’investissement, de la propriété et de la gestion des actifs d’interroger des modèles financiers, des insights de maintenance prédictive, de l’analyse du marché et des données de portefeuille à l’aide du langage naturel. Les utilisateurs peuvent poser des questions opérationnelles complexes, explorer des scénarios stratégiques et effectuer une analyse sans extraction manuelle des données, toutes ancrées dans des données Yardi précises et de classe entreprise.

Le connecteur est une implémentation du protocole MCP (Model Context Protocol), une norme ouverte pour connecter des assistants IA à des systèmes externes tels que des outils métier, des référentiels de données et des environnements de développement. Au lieu d’exposer un ensemble fixe d’opérations REST, le connecteur parle MCP sur http streamable, de sorte que le serveur Yardi Virtuoso MCP publie ses propres outils et ressources à l’agent appelant au moment de l’exécution. Cela signifie que les nouvelles fonctionnalités Yardi deviennent disponibles pour les agents sans republier le connecteur.

Prerequisites

Vous devez procéder comme suit :

  • Un plan Microsoft Power Apps ou Power Automate avec la fonctionnalité de connecteur personnalisé
  • Une licence Microsoft Copilot Studio, pour les agents qui consomment le serveur MCP
  • Un abonnement Yardi Virtuoso sous licence
  • Un compte YardiOne ayant accès aux données et outils Yardi que vous envisagez d’interroger
  • Outils CLI Power Platform (paconn), si vous effectuez un déploiement à partir de la source plutôt que d’importer la solution gérée

Génération du connecteur

Le serveur MCP Yardi Virtuoso est sécurisé par YardiOne, qui agit comme serveur d’autorisation OAuth 2.0. L’authentification utilise OAuth 2.0 avec des métadonnées de ressources protégées et PKCE (oauth2pkcewithprm), de sorte que le connecteur découvre le serveur d’autorisation et s’inscrit dynamiquement au lieu de s’appuyer sur un ID client et un secret préprovisionnés.

En raison de ce flux de découverte, il n’existe aucune étape d’inscription d’application Entra ID et aucune clé secrète client à gérer. Le connecteur déclare l’adresse du serveur MCP et Power Platform gère le reste de la négociation :

  1. Le connecteur publie sa ressource protégée, https://mcp.virtuoso.ai/mcpvia le paramètre de ServerUrl connexion.
  2. Lors de la première connexion, Power Platform récupère les métadonnées de ressource protégées à partir du serveur MCP, qui pointe vers le serveur d’autorisation YardiOne.
  3. Le connecteur s’inscrit dynamiquement auprès de YardiOne et redirige l’utilisateur pour se connecter.
  4. YardiOne émet un jeton d’accès étendu à cet utilisateur, et le connecteur l’attache en tant que jeton de porteur sur chaque requête MCP.

L’accès est donc évalué par utilisateur par rapport à ses droits YardiOne. Un agent peut uniquement atteindre les données et outils Yardi que l’utilisateur connecté est déjà autorisé à voir, et chaque appel d’outil est auditable à cette identité.

L’URL de redirection configurée pour ce connecteur est la suivante :

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

Il s’agit d’une GlobalPerConnector redirection. Il est donc spécifique à cette inscription de connecteur et doit être répertorié par le serveur d’autorisation YardiOne.

Déploiement du connecteur

Importez la solution managée incluse dans ce package :

pac solution import --path YardiVirtuosoConnector_1_0_0_2_managed.zip

La solution empaquette le composant connecteur personnalisé uniquement. Il ne contient aucune table, flux de travail ou rôles de sécurité supplémentaires.

Propriété Value
Nom unique de la solution YardiVirtuosoConnector
Version de la solution 1.0.0.2 (managé)
Éditeur Yardi_Virtuoso_developer (préfixe virtuoso)
Nom interne du connecteur cre88_5Fvirt-5Fprod-5Fdyn-5Foauth-5Fdisc
Host mcp.virtuoso.ai
Point de terminaison MCP POST /mcp
Protocole agentique mcp-streamable-1.0

Vous pouvez également déployer à partir de la définition du connecteur dans ce référentiel :

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

Opérations prises en charge

Le connecteur expose une seule opération Power Platform, qui porte le protocole MCP :

  • Yardi Virtuoso (InvokeServer) : appelle le serveur Yardi Virtuoso MCP sur http streamable. Il s’agit du transport de tout le trafic MCP, y compris la découverte d’outils et l’appel d’outil.

Les agents n’appellent pas cette opération directement. Une fois qu’une connexion est autorisée, Copilot Studio émet une demande MCP tools/list et le serveur Yardi Virtuoso retourne les outils disponibles pour l’utilisateur connecté. L’agent appelle ensuite ces outils par nom. Étant donné que le catalogue d’outils est servi par Yardi Virtuoso plutôt que déclaré dans la définition OpenAPI du connecteur, il peut changer côté serveur sans mettre à jour le connecteur.

Problèmes connus et limitations

  • Le connecteur utilise le mcp-streamable-1.0 protocole agentique et est destiné à être utilisé dans Microsoft Copilot Studio agents. Elle n’est pas conçue pour être utilisée comme action conventionnelle dans Power Automate flux ou Power Apps.
  • Le catalogue d’outils est résolu lors de l’exécution à partir du serveur Yardi Virtuoso MCP. Les opérations disponibles pour un agent dépendent de la version du serveur et des droits YardiOne de l’utilisateur connecté.
  • Chaque connexion est liée à un utilisateur YardiOne individuel. La connexion au nom de l’utilisateur n’est pas prise en charge. Par conséquent, les connexions ne peuvent pas être partagées entre les utilisateurs.
  • L’accès sortant vers mcp.virtuoso.ai https est requis. Les environnements qui limitent la sortie doivent autoriser les étiquettes de service Azure utilisées par Power Platform dans la région appropriée.

Actions

Yardi Virtuoso

Yardi Virtuoso offre un accès sécurisé et en temps réel aux données et outils Yardi par le biais du copilote. Il permet aux professionnels de l’investissement, de la propriété et de la gestion des actifs d’interroger des modèles financiers, des insights de maintenance prédictive, de l’analyse du marché et des données de portefeuille à l’aide du langage naturel. Les utilisateurs peuvent poser des questions opérationnelles complexes, explorer des scénarios stratégiques et effectuer une analyse sans extraction manuelle des données, toutes ancrées dans des données Yardi précises et de classe entreprise.

Yardi Virtuoso

Yardi Virtuoso offre un accès sécurisé et en temps réel aux données et outils Yardi par le biais du copilote. Il permet aux professionnels de l’investissement, de la propriété et de la gestion des actifs d’interroger des modèles financiers, des insights de maintenance prédictive, de l’analyse du marché et des données de portefeuille à l’aide du langage naturel. Les utilisateurs peuvent poser des questions opérationnelles complexes, explorer des scénarios stratégiques et effectuer une analyse sans extraction manuelle des données, toutes ancrées dans des données Yardi précises et de classe entreprise.