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
Email 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:

  1. O conector anuncia seu recurso protegido, https://mcp.virtuoso.ai/mcppor meio do ServerUrl parâmetro de conexão.
  2. 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.
  3. O conector se registra dinamicamente no YardiOne e redireciona o usuário para entrar.
  4. 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.0 protocolo 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.ai https é 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.