Yardi Virtuoso (versão prévia)
O Yardi Virtuoso fornece acesso seguro e em tempo real aos dados e ferramentas da Yardi por meio do Co-Piloto. Ele permite que profissionais de investimento, propriedade e gestão de ativos consultem modelos financeiros, insights de manutenção preditiva, análise de mercado e dados de portfólio usando linguagem natural. Os usuários podem fazer perguntas operacionais complexas, explorar cenários estratégicos e executar análises sem extração manual de dados, tudo fundamentado em dados yardi precisos e de nível empresarial.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - 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 (GCC) – 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 (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Name | Yardi Systems, Inc. |
| URL | https://www.yardi.com |
| support@yardi.com |
| Metadados do conector | |
|---|---|
| Publicador | 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 de empresas |
| Documentation | https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide |
| Suporte | https://www.yardi.com/company/technical-support/ |
Yardi Virtuoso Connector
O Yardi Virtuoso fornece acesso seguro e em tempo real aos dados e ferramentas da Yardi por meio de Microsoft Copilot. Ele permite que profissionais de investimento, propriedade e gestão de ativos consultem modelos financeiros, insights de manutenção preditiva, análise de mercado e dados de portfólio usando linguagem natural. Os usuários podem fazer perguntas operacionais complexas, explorar cenários estratégicos e executar análises sem extração manual de dados, tudo fundamentado em dados yardi precisos e de nível empresarial.
O conector é uma implementação do Protocolo de Contexto de Modelo (MCP), um padrão aberto para conectar assistentes de IA a sistemas externos, como ferramentas de negócios, repositórios de dados e ambientes de desenvolvimento. Em vez de expor um conjunto fixo de operações REST, o conector fala MCP sobre HTTP transmitivel, de modo que o servidor YARDI Virtuoso MCP anuncia suas próprias ferramentas e recursos para o agente de chamada em runtime. Isso significa que novas funcionalidades yardi ficam disponíveis para agentes sem republicar o conector.
Prerequisites
Você precisará do seguinte para continuar:
- Um plano do Microsoft Power Apps ou do Power Automate com o recurso de conector personalizado
- Uma licença Microsoft Copilot Studio, para agentes que consomem o servidor MCP
- Uma assinatura licenciada do Yardi Virtuoso
- Uma conta YardiOne com acesso aos dados e ferramentas do Yardi que você pretende consultar
- As ferramentas da CLI do Power Platform (
paconn), se você estiver implantando da origem em vez de importar a solução gerenciada
Compilando o conector
O servidor YARDI Virtuoso MCP é protegido pela YardiOne, que atua como o servidor de autorização do OAuth 2.0. A autenticação usa o OAuth 2.0 com PKCE e metadados de recursos protegidos (oauth2pkcewithprm), de modo que o conector descobre o servidor de autorização e se registra dinamicamente em vez de depender de uma ID e segredo de cliente pré-provisionados.
Devido a esse fluxo de descoberta, não há Entra ID etapa de registro do aplicativo e nenhum segredo do cliente a ser gerenciado. O conector declara o endereço do servidor MCP e o Power Platform manipula o restante do handshake:
- O conector anuncia seu recurso protegido,
https://mcp.virtuoso.ai/mcppor meio doServerUrlparâmetro de conexão. - Na primeira conexão, o Power Platform busca os metadados de recursos protegidos do servidor MCP, que aponta para o servidor de autorização YardiOne.
- O conector se registra dinamicamente no YardiOne e redireciona o usuário para entrar.
- O YardiOne emite um token de acesso com escopo para esse usuário e o conector o anexa como um token de portador em cada solicitação MCP.
O Access é, portanto, avaliado por usuário em relação aos direitos do YardiOne. Um agente só pode acessar os dados e as ferramentas do Yardi que o usuário conectado já tem permissão para ver e cada invocação de ferramenta pode ser auditada 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
Esse é um GlobalPerConnector redirecionamento, portanto, é específico para esse registro de conector e deve ser listado por permissão pelo servidor de autorização YardiOne.
Implantando o conector
Importe a solução gerenciada incluída neste pacote:
pac solution import --path YardiVirtuosoConnector_1_0_0_2_managed.zip
A solução empacota apenas o componente do conector personalizado. Ele não contém tabelas, fluxos de trabalho ou funções de segurança adicionais.
| Property | Value |
|---|---|
| Nome exclusivo da solução | YardiVirtuosoConnector |
| Versão da solução |
1.0.0.2 (gerenciado) |
| Publicador |
Yardi_Virtuoso_developer (prefixo virtuoso) |
| Nome interno do conector | cre88_5Fvirt-5Fprod-5Fdyn-5Foauth-5Fdisc |
| Host | mcp.virtuoso.ai |
| Ponto de extremidade MCP | POST /mcp |
| Protocolo agentic | mcp-streamable-1.0 |
Como alternativa, para implantar a partir da definição do conector neste repositório:
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json
Operações com suporte
O conector expõe uma única operação do Power Platform, que carrega o protocolo MCP:
-
Yardi Virtuoso(InvokeServer): Invoca o servidor YARDI Virtuoso MCP por HTTP que pode ser transmitido. Esse é o transporte para todo o tráfego MCP, incluindo a descoberta de ferramentas e a invocação de ferramentas.
Os agentes não chamam essa operação diretamente. Depois que uma conexão é autorizada, Copilot Studio emite uma solicitação MCP tools/list e o servidor Yardi Virtuoso retorna as ferramentas disponíveis para o usuário conectado. Em seguida, o agente 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, ele pode ser alterado no lado do servidor sem uma atualização do conector.
Problemas e limitações conhecidos
- O conector usa o
mcp-streamable-1.0protocolo agente e destina-se a ser usado em Microsoft Copilot Studio agentes. Ele não foi projetado para uso como uma ação convencional em Power Automate fluxos ou Power Apps. - O catálogo de ferramentas é resolvido em runtime do servidor Yardi Virtuoso MCP, portanto, as operações disponíveis para um agente dependem da versão do servidor e dos direitos yardiOne do usuário conectado.
- Cada conexão é associada a um usuário individual do YardiOne. Não há suporte para logon em nome do usuário, portanto, as conexões não podem ser compartilhadas entre os usuários.
- O acesso de saída para
mcp.virtuoso.aihttps é necessário. Ambientes que restringem a saída devem permitir as marcas 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 da Yardi por meio do Co-Piloto. Ele permite que profissionais de investimento, propriedade e gestão de ativos consultem modelos financeiros, insights de manutenção preditiva, análise de mercado e dados de portfólio usando linguagem natural. Os usuários podem fazer perguntas operacionais complexas, explorar cenários estratégicos e executar análises sem extração manual de dados, tudo fundamentado 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 da Yardi por meio do Co-Piloto. Ele permite que profissionais de investimento, propriedade e gestão de ativos consultem modelos financeiros, insights de manutenção preditiva, análise de mercado e dados de portfólio usando linguagem natural. Os usuários podem fazer perguntas operacionais complexas, explorar cenários estratégicos e executar análises sem extração manual de dados, tudo fundamentado em dados yardi precisos e de nível empresarial.