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 :
- Le connecteur publie sa ressource protégée,
https://mcp.virtuoso.ai/mcpvia le paramètre deServerUrlconnexion. - 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.
- Le connecteur s’inscrit dynamiquement auprès de YardiOne et redirige l’utilisateur pour se connecter.
- 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.0protocole 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.aihttps 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.