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 |
| 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 負責其餘握手:
- 連接器透過連接參數通告其受保護的資源
https://mcp.virtuoso.ai/mcp。ServerUrl - 首次連線時,Power Platform 會從指向 YardiOne 授權伺服器的 MCP 伺服器取得受保護的資源元資料。
- 連接器會動態向 YardiOne 註冊,並引導使用者登入。
- 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 數據之上。