Yardi Virtuoso(預覽)

Yardi Virtuoso 透過 Co-Pilot 提供安全且即時的 Yardi 資料與工具存取。 它讓投資、物業及資產管理專業人士能利用自然語言查詢財務模型、預測性維護洞察、市場分析及投資組合資料。 使用者可以提出複雜的操作問題,探索策略情境,並進行分析,無需手動擷取資料,所有這些都建立在準確且企業級的 Yardi 數據之上。

此連接器適用於以下產品和區域:

Service Class Regions
Copilot Studio 進階 除下列區域外的所有 Power Automate 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人
Name 雅迪系統公司
URL https://www.yardi.com
Email support@yardi.com
連接器中繼資料
Publisher 雅迪系統有限責任公司
Yardi Virtuoso MCP 技術文件指南 https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide
Website https://www.yardi.com
隱私權原則 https://resources.yardi.com/legal/privacy-statement/
Categories 人工智慧;企業管理
Documentation https://help.virtuoso.ai/en/articles/13679727-yardi-virtuoso-mcp-technical-documentation-guide
支援 https://www.yardi.com/company/technical-support/

雅迪維爾特奧索連接器

Yardi Virtuoso 透過 Microsoft Copilot 提供安全且即時的 Yardi 資料與工具存取。 它讓投資、物業及資產管理專業人士能利用自然語言查詢財務模型、預測性維護洞察、市場分析及投資組合資料。 使用者可以提出複雜的操作問題,探索策略情境,並進行分析,無需手動擷取資料,所有這些都建立在準確且企業級的 Yardi 數據之上。

該連接器是 模型情境協定(Model Context Protocol,MCP)的實作,MCP 是一項開放標準,用於將 AI 助理與外部系統(如商業工具、資料庫及開發環境)連接起來。 連接器不再暴露固定的 REST 操作集合,而是透過可串流的 HTTP 以 MCP 溝通,因此 Yardi Virtuoso MCP 伺服器會在執行時向呼叫代理宣告其自身的工具與資源。 這表示新的 Yardi 功能可以開放給代理,而無需重新發布連接器。

Prerequisites

您將需要以下內容才能繼續:

  • 具有自訂連接器功能的 Microsoft Power Apps 或 Power Automate 方案
  • Microsoft Copilot Studio 授權,適用於使用MCP伺服器的代理程式
  • 授權的 Yardi Virtuoso 訂閱
  • 一個擁有 YardiOne 資料及你打算查詢工具的帳號
  • Power Platform CLI 工具 (paconn),如果你是從來源部署,而非匯入受管理解決方案

建置連接器

Yardi Virtuoso MCP 伺服器由 YardiOne 保護,YardiOne 作為 OAuth 2.0 授權伺服器。 認證使用 OAuth 2.0,搭配 PKCE 與受保護資源中繼資料(Protected Resource Metadata,),oauth2pkcewithprm因此連接器能偵測授權伺服器並動態註冊,而非依賴預先配置的客戶端 ID 與秘密。

因為有這個發現流程,沒有 Entra ID 應用程式註冊步驟,也沒有客戶端秘密需要管理。 連接器宣告 MCP 伺服器位址,Power Platform 負責其餘握手:

  1. 連接器透過連接參數通告其受保護的資源 https://mcp.virtuoso.ai/mcp。ServerUrl
  2. 首次連線時,Power Platform 會從指向 YardiOne 授權伺服器的 MCP 伺服器取得受保護的資源元資料。
  3. 連接器會動態向 YardiOne 註冊,並引導使用者登入。
  4. YardiOne 會為該使用者發出一個權限範圍的存取權杖,連接器會在每個 MCP 請求時將其作為承載權杖附加。

因此,存取權會根據每位用戶的 YardiOne 權限進行評估。 代理人員只能存取已登入使用者已被允許查看的 Yardi 資料與工具,且每次工具調用都可以被審核回該身份。

此連接器所設定的重定向網址為:

https://global.consent.azure-apim.net/redirect/cre88-5fvirt-5fprod-5fdyn-5foauth-5fdisc-5f985796682d33968b

這是 GlobalPerConnector 重定向,因此是針對此連接器註冊的專用,且必須由 YardiOne 授權伺服器列入允許清單。

部署連接器

匯入本套件中包含的管理解決方案:

pac solution import --path YardiVirtuosoConnector_1_0_0_2_managed.zip

該解決方案僅打包客製化連接器元件。 它不包含額外的資料表、工作流程或安全角色。

Property Value
解的唯一名稱 YardiVirtuosoConnector
解決方案版本 1.0.0.2 (管理)
Publisher Yardi_Virtuoso_developer (前綴 virtuoso)
連接器內部名稱 cre88_5Fvirt-5Fprod-5Fdyn-5Foauth-5Fdisc
Host mcp.virtuoso.ai
MCP 端點 POST /mcp
代理協定 mcp-streamable-1.0

或者,從本儲存庫中的連接器定義部署:

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json

支援的作業

該連接器僅可執行單一 Power Platform 操作,承載 MCP 協定:

  • Yardi Virtuoso (InvokeServer): 透過可串流的 HTTP 調用 Yardi Virtuoso MCP 伺服器。 這是所有 MCP 流量的傳輸,包括工具發現與工具調用。

代理人不會直接呼叫該行動。 連線授權後,Copilot Studio 會發出 MCP tools/list 請求,Yardi Virtuoso 伺服器會回傳登入使用者可用的工具。 代理人接著會以名稱呼叫這些工具。 由於工具目錄是由 Yardi Virtuoso 提供,而非連接器的 OpenAPI 定義中宣告,因此可以在伺服器端自行更改,無需連接器更新。

已知問題和限制

  • 該連接器採用mcp-streamable-1.0代理協定,設計用於 Microsoft Copilot Studio 代理程式。 它並非設計用於 Power Automate 流程或 Power Apps 中的傳統動作。
  • 工具目錄在執行時由 Yardi Virtuoso MCP 伺服器解析,因此代理可操作的操作取決於伺服器版本及登入使用者的 YardiOne 權限。
  • 每個連線都綁定給一位個別的 YardiOne 使用者。 不支援代為登入,因此無法在使用者間共享連線。
  • 需要透過 HTTPS 進行外撥存取 mcp.virtuoso.ai 。 限制出口的環境必須允許 Power Platform 在相關區域使用 Azure 服務標籤。

動作

雅迪·維爾特奧索

Yardi Virtuoso 透過 Co-Pilot 提供安全且即時的 Yardi 資料與工具存取。 它讓投資、物業及資產管理專業人士能利用自然語言查詢財務模型、預測性維護洞察、市場分析及投資組合資料。 使用者可以提出複雜的操作問題,探索策略情境,並進行分析,無需手動擷取資料,所有這些都建立在準確且企業級的 Yardi 數據之上。

雅迪·維爾特奧索

Yardi Virtuoso 透過 Co-Pilot 提供安全且即時的 Yardi 資料與工具存取。 它讓投資、物業及資產管理專業人士能利用自然語言查詢財務模型、預測性維護洞察、市場分析及投資組合資料。 使用者可以提出複雜的操作問題,探索策略情境,並進行分析,無需手動擷取資料,所有這些都建立在準確且企業級的 Yardi 數據之上。