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

  1. O conector anuncia o seu recurso protegido, https://mcp.virtuoso.ai/mcp, através do ServerUrl parâmetro de ligação.
  2. 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.
  3. O conector regista-se dinamicamente com o YardiOne e redireciona o utilizador para iniciar sessão.
  4. 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.0 protocolo 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.ai via 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.