Yardi Virtuoso (Pré-visualização)
O Yardi Virtuoso fornece acesso seguro e em tempo real aos dados e ferramentas do Yardi através do Co-Pilot. Permite que profissionais de investimento, gestão de propriedades e ativos consultem modelos financeiros, insights de manutenção preditiva, análise de mercado e dados de carteira usando linguagem natural. Os utilizadores podem colocar questões operacionais complexas, explorar cenários estratégicos e realizar análises sem extração manual de dados, tudo baseado em dados Yardi precisos e de nível empresarial.
Este conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contact | |
|---|---|
| Name | Yardi Systems, Inc. |
| URL | https://www.yardi.com |
| support@yardi.com |
| Metadados do conector | |
|---|---|
| Publisher | Yardi Systems LLC |
| Guia de documentação técnica do Yardi Virtuoso MCP | https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide |
| Website | https://www.yardi.com |
| Política de privacidade | https://resources.yardi.com/legal/privacy-statement/ |
| Categories | IA; Gestão Empresarial |
| Documentation | https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide |
| Suporte | https://www.yardi.com/company/technical-support/ |
Conector Yardi Virtuoso
O Yardi Virtuoso fornece acesso seguro e em tempo real aos dados e ferramentas Yardi através do Microsoft Copilot. Permite que profissionais de investimento, gestão de propriedades e ativos consultem modelos financeiros, insights de manutenção preditiva, análise de mercado e dados de carteira usando linguagem natural. Os utilizadores podem colocar questões operacionais complexas, explorar cenários estratégicos e realizar análises sem extração manual de dados, tudo baseado em dados Yardi precisos e de nível empresarial.
O conector é uma implementação do Model Context Protocol (MCP), um padrão aberto para ligar assistentes de IA a sistemas externos, como ferramentas empresariais, repositórios de dados e ambientes de desenvolvimento. Em vez de expor um conjunto fixo de operações REST, o conector fala MCP através de HTTP streamable, pelo que o servidor MCP Yardi Virtuoso anuncia as suas próprias ferramentas e recursos ao agente chamador em tempo de execução. Isto significa que novas capacidades Yardi ficam disponíveis para os agentes sem necessidade de republicar o conector.
Prerequisites
Você precisará do seguinte para prosseguir:
- Um plano Microsoft Power Apps ou Power Automate com o recurso de conector personalizado
- Uma licença Microsoft Copilot Studio, para agentes que consomem o servidor MCP
- Uma subscrição licenciada do Yardi Virtuoso
- Uma conta YardiOne com acesso aos dados e ferramentas Yardi que pretende consultar
- As ferramentas de CLI da Power Platform (
paconn), se estiveres a implementar a partir da origem em vez de importar a solução gerida
Construindo o conector
O servidor MCP Yardi Virtuoso é protegido pela YardiOne, que atua como servidor de autorização OAuth 2.0. A autenticação utiliza OAuth 2.0 com PKCE e Metadados de Recursos Protegidos (oauth2pkcewithprm), pelo que o conector descobre o servidor de autorização e regista-se dinamicamente em vez de depender de um ID de cliente pré-provisionado e um segredo.
Por causa desse fluxo de descoberta, não há nenhum passo de registo da aplicação Entra ID nem segredo do cliente para gerir. O conector declara o endereço do servidor MCP e o Power Platform trata do resto do handshake:
- O conector anuncia o seu recurso protegido,
https://mcp.virtuoso.ai/mcp, através doServerUrlparâmetro de ligação. - Na primeira ligação, o Power Platform obtém os metadados de recursos protegidos do servidor MCP, que apontam para o servidor de autorização YardiOne.
- O conector regista-se dinamicamente com o YardiOne e redireciona o utilizador para iniciar sessão.
- A YardiOne emite um token de acesso direcionado a esse utilizador, e o conector anexa-o como token portador em cada pedido MCP.
O acesso é, portanto, avaliado por utilizador com base nos seus direitos YardiOne. Um agente só pode aceder aos dados e ferramentas Yardi que o utilizador iniciado já tem permissão para ver, e cada invocação de ferramenta é auditável de volta para essa identidade.
A URL de redirecionamento configurada para este conector é:
https://global.consent.azure-apim.net/redirect/cre88-5fvirt-5fprod-5fdyn-5foauth-5fdisc-5f985796682d33968b
Isto é um GlobalPerConnector redirecionamento, por isso é específico para este registo do conector e deve ser listado pelo servidor de autorização da YardiOne.
Implantando o conector
Importa a solução gerida incluída neste pacote:
pac solution import --path YardiVirtuosoConnector_1_0_0_2_managed.zip
A solução inclui apenas o componente do conector personalizado. Não contém tabelas adicionais, fluxos de trabalho ou funções de segurança.
| Property | Value |
|---|---|
| Nome único da solução | YardiVirtuosoConnector |
| Versão da solução |
1.0.0.2 (conseguido) |
| Publisher |
Yardi_Virtuoso_developer (prefixo virtuoso) |
| Nome interno do conector | cre88_5Fvirt-5Fprod-5Fdyn-5Foauth-5Fdisc |
| Host | mcp.virtuoso.ai |
| Ponto final MCP | POST /mcp |
| Protocolo agente | mcp-streamable-1.0 |
Alternativamente, para implementar a partir da definição do conector neste repositório:
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json
Operações suportadas
O conector expõe uma única operação Power Platform, que transporta o protocolo MCP:
-
Yardi Virtuoso(InvokeServer): Invoca o servidor MCP Yardi Virtuoso através de HTTP streamable. Este é o transporte para todo o tráfego MCP, incluindo descoberta e invocação de ferramentas.
Os agentes não chamam essa operação diretamente. Uma vez autorizada uma ligação, o Copilot Studio emite um pedido MCP tools/list e o servidor Yardi Virtuoso devolve as ferramentas disponíveis ao utilizador iniciado sessão. O agente então invoca essas ferramentas pelo nome. Como o catálogo de ferramentas é servido pelo Yardi Virtuoso em vez de declarado na definição OpenAPI do conector, pode mudar do lado do servidor sem uma atualização do conector.
Problemas conhecidos e limitações
- O conector utiliza o
mcp-streamable-1.0protocolo agentico e destina-se a ser utilizado em agentes do Microsoft Copilot Studio. Não foi concebido para ser usado como uma ação convencional em fluxos do Power Automate ou Power Apps. - O catálogo de ferramentas é resolvido em tempo de execução a partir do servidor Yardi Virtuoso MCP, pelo que as operações disponíveis para um agente dependem da versão do servidor e dos direitos YardiOne do utilizador iniciado.
- Cada ligação está ligada a um utilizador individual do YardiOne. O login em nome do utilizador não é suportado, pelo que as ligações não podem ser partilhadas entre utilizadores.
- É necessário acesso de saída ao
mcp.virtuoso.aivia HTTPS. Ambientes que restringem a saída devem permitir as etiquetas de serviço Azure usadas pelo Power Platform na região relevante.
Ações
| Yardi Virtuoso |
O Yardi Virtuoso fornece acesso seguro e em tempo real aos dados e ferramentas do Yardi através do Co-Pilot. Permite que profissionais de investimento, gestão de propriedades e ativos consultem modelos financeiros, insights de manutenção preditiva, análise de mercado e dados de carteira usando linguagem natural. Os utilizadores podem colocar questões operacionais complexas, explorar cenários estratégicos e realizar análises sem extração manual de dados, tudo baseado em dados Yardi precisos e de nível empresarial. |
Yardi Virtuoso
O Yardi Virtuoso fornece acesso seguro e em tempo real aos dados e ferramentas do Yardi através do Co-Pilot. Permite que profissionais de investimento, gestão de propriedades e ativos consultem modelos financeiros, insights de manutenção preditiva, análise de mercado e dados de carteira usando linguagem natural. Os utilizadores podem colocar questões operacionais complexas, explorar cenários estratégicos e realizar análises sem extração manual de dados, tudo baseado em dados Yardi precisos e de nível empresarial.