Microsoft Teams 中的 Databricks Genie 應用程式將 Genie 帶入 Microsoft Teams,讓使用者能在不離開 Microsoft Teams 工作空間的情況下提出資料問題並獲得答案。 使用者可以透過私訊與應用程式聊天,或@Databricks Genie在 Microsoft Teams 頻道或群組聊天中提及。 問題由 Genie One 或在私訊或頻道中釘選的特定 Genie Agent 回答,提供一致且針對特定使用情境的回答。
當 Genie 代理被釘選時,新的對話會透過 代理模式 API 以代理模式直接傳送到該代理。 否則,Microsoft Teams 中的 Databricks Genie 應用程式則使用 Genie One API。 該應用程式使用與 Genie 相同的供應商模式及信任與安全保障。 請參閱「 啟用與停用合作夥伴驅動 AI 功能設定時所使用的主機供應商 」,以及 Databricks AI 輔助功能、信任與安全性。
本頁說明如何在 Microsoft Teams 中下載、設定及使用 Databricks Genie 應用程式。
Important
Azure Databricks 代理可能會產生不準確的回應。 在處理代理人輸出前,先驗證。
先決條件
在 Microsoft Teams 安裝 Databricks Genie 應用程式前:
- 要上傳私訊檔案,每位使用者的 Microsoft Teams 帳號必須有 商務用 OneDrive。 請參閱 上傳檔案。
- 要讓使用者在私訊中將文件儲存為 PDF,每位使用者都需要 OneDrive 以及 Microsoft Teams 中 Databricks Genie 應用程式 1.0.17 及以上版本。 請參見「將文件儲存為 PDF」。
- 如果您的工作區使用 IP 存取清單,請將 Azure Databricks 在 East US 2 區域控制平面的輸出 IP 加入清單。 請參考Azure Databricks文件中的外撥IP。
- 如果你的工作區使用 Private Link,帳號管理員必須新增一個基於上下文的 Ingress 規則,允許該應用程式存取。 請參見使用 Private Link 工作區。
在 Microsoft Teams 中安裝 Databricks Genie 應用程式
一位 Microsoft 365 管理員從 Microsoft 市集安裝 Databricks Genie 應用程式到Microsoft Teams:
- 在 Microsoft 市集中,搜尋並找到 Databricks Genie。
- 安裝應用程式。
- 安裝過程中出現提示時,請允許應用程式權限。
如需必要權限清單,請參閱 Microsoft 的必要應用程式權限。
安裝後,使用者即可開始使用該應用程式。
在 Microsoft Teams 中使用 Databricks Genie 應用程式
你可以在 Microsoft Teams 中,透過私訊或 Microsoft Teams 工作區中的頻道對話使用 Databricks Genie 應用程式,或從 Microsoft 365 Copilot 使用。
私訊
若要直接在 Microsoft Teams 中向 Databricks Genie 應用程式傳送訊息:
在 Microsoft Teams 中,點選左側邊欄的應用程式,並在 Microsoft Teams 中開啟 Databricks Genie 應用程式。
輸入您的問題。
如果您尚未登入,Microsoft Teams 中的 Databricks Genie 應用程式會提示您登入:
- 按一下 [設定]。
- 請指定你的 工作區網址。 要找到你的工作區網址,請參見 工作區實例名稱、URL 和 ID。
- 點擊繼續登入您的 Azure Databricks 帳號。
您的問題會轉送給最合適的 Genie Agent,並返回附有來源和建議後續提示的答案。
若要在私訊中開啟新對話,請發送 newchat。 這樣可以清除當前對話的上下文,讓你的下一則訊息開始新的精靈對話。 你現有的 Microsoft Teams 訊息並未被刪除。
要設定所有後續私訊對話的工作空間與 Genie 範圍,請在 Microsoft Teams 首頁開啟 Databricks Genie 應用程式並調整設定。
透過私訊排程任務
你可以在 Microsoft Teams 裡用 Databricks Genie 應用程式,透過私訊建立排程任務。 請使用下列其中一個方法:
- 請 Genie 幫忙安排它。 在對話的任何時刻,都可以用自然語言輸入請求,例如:「建立一個每日排程,擷取最新的客戶支出。」 Genie 可能會詢問澄清問題,例如時間或時區,然後建立任務。
- 點擊排程建議。 當 Genie 建議依排程執行答案時,答案下方會顯示「想依排程執行此分析嗎?」按鈕。 按一下按鈕。 精靈會問任務應該做什麼、什麼時候執行,然後建立任務。
當任務執行時,Microsoft Teams 中的 Databricks Genie 應用程式會以私訊方式將結果傳送給你。 若要繼續討論結果,請點擊 「詢問後續」。
上傳檔案
在私訊中,你可以附加最多五個 20 MiB 或更小的 PDF、Word 或 CSV 檔案,Genie 在回覆時會用這些檔案作為上下文。 檔案上傳功能無法在頻道、群組聊天、Microsoft 365 Copilot 或與置頂的 Genie Agent 對話中使用。
Microsoft Teams 會將你在聊天中附加的檔案儲存在 商務用 OneDrive 中,因此你的 Microsoft Teams 帳號必須有 商務用 OneDrive 才能上傳檔案。
若要上傳檔案:
- 在 Microsoft Teams 的 Databricks Genie 應用程式私訊中,最多可將五個檔案附加到您的訊息中。
- 可選擇性地輸入關於檔案的問題。
- 發送訊息。
如果你的訊息包含問題,Genie 會上傳檔案,然後用這些檔案回答問題。 如果你傳送檔案而未提出問題,Genie 會上傳檔案並在檔案準備就緒時確認。 接著你可以詢問有關檔案的問題。
上傳的檔案在目前的對話中仍可供後續提問使用。 發送 newchat完後,再附上檔案,以便在新的對話中使用這些檔案。
如果你附加超過五個檔案,Genie 會上傳前五個並列出它跳過的檔案。 如果檔案無法上傳,Genie 會列出該檔案及其原因。 只要至少成功上傳一個檔案,Genie 還是會回答你的問題。
如果 Genie 回覆說 Azure Databricks 無法授權上傳,請重新連接 Azure Databricks 並重新嘗試。 如果還是失敗,請工作區管理員檢查你的檔案上傳權限。
將文件儲存為 PDF
當 Genie 在私訊中草擬文件時,Microsoft Teams 中的 Databricks Genie 應用程式會將文件以 PDF 格式呈現在檔案卡上。 想了解如何請 Genie 起草文件,請參閱 Genie One 中的文件。
要將 PDF 儲存到 OneDrive,請在檔案卡片上點擊 「允許」。 App 會把卡片換成聊天裡的 PDF。 若要略過此優惠,請按一下 拒絕。
要儲存 PDF,你需要 OneDrive,且 Microsoft Teams 中的 Databricks Genie 應用程式須為 1.0.17 或以上版本。 如果因為你的帳號停用 OneDrive 而點擊允許失敗,請改用 Genie One 開啟該文件。
- PDF的名稱取自文件標題。
- 如果回應包含多份文件,應用程式只會提供第一份文件。
- 優惠在應用程式發布後15分鐘到期。 如果 PDF 傳送忙碌或無法開始,卡片會要求你再次點擊 允許 。 請在優惠到期前完成此操作。 要在優惠到期後取得 PDF,請請 Genie 重新產生該文件。
- 超過 20 MiB 的 PDF 無法儲存。 請直接在 Genie One 開啟文件。
頻道對話
你可以在 Microsoft Teams 中新增 Databricks Genie 應用程式到頻道中。 利用 config,頻道擁有者可為頻道所有成員設定,個別使用者則可設定個人設定。 頻道擁有者設定會覆蓋個人設定。
若要在 Microsoft Teams 的頻道中設定 Databricks Genie 應用程式:
在目標通道中輸入
@Databricks Genie。如果被要求,請將 Microsoft Teams 中的 Databricks Genie 應用程式加入該頻道。
輸入
config。選擇已連接的工作區、訊息可見性,以及 Genie 範圍(Genie One 或特定的 Genie 代理)。
若未釘選任何 Genie 代理程式,該頻道會預設為 Genie One。
設定完成後,通道中的所有
@Databricks Genie提及都會導向已設定的代理和工作區。
Visualizations
當 Genie 回應包含視覺化時,該圖表會以圖片形式出現在回覆中。
核准工具操作
Genie 可以利用 連接的外部工具 來回答問題並執行行動。 當工具呼叫需要核准時,Genie 會在回覆中顯示核准卡。 點擊 允許 讓精靈執行工具,或點擊 拒絕 以停止其執行。 如果卡片有範圍選擇器,可以選擇核准的適用範圍是「一次」、「一律在此聊天中」或「永遠」。 只有提出問題的使用者能批准或拒絕請求。
設定層級與覆寫
在通道中執行 config 以開啟設定視窗。 以下設定可設定:
- 工作區選擇:Microsoft Teams 中的 Databricks Genie 應用程式為回答問題所連線的 Azure Databricks 工作區。
-
訊息可見性:頻道內的回應是否
@Databricks Genie對所有頻道成員可見,或僅對提問的使用者可見。 預設情況下,回應是公開的。 - 精靈範圍:精靈一號或特定的精靈代理人。 新對話會直接傳送給 代理人模式 中的置頂代理人,而對其回答提供的意見回饋會傳送給該代理人。 在 Microsoft 365 Copilot 中,直接訊息中的釘選也適用。 在頻道或群組聊天中,只有一個頻道範圍的 PIN (儲存為頻道範圍設定)會將對話導向客服人員。 頻道中的個人配置使用 Genie One。
訊息可見性設定可分為三個層級。 較高等級覆蓋較低等級:
| 等級 | 如何設定 | 適用對象 | 優先權 |
|---|---|---|---|
| 工作區 | Azure Databricks 工作區管理員可在工作區安全性設定中設定 允許的協作平台 和 允許在協作平台中傳送公開訊息。 當「 允許協作平台公開訊息 」關閉時,所有回應對提問的使用者都是私密的。 |
Microsoft Teams 工作空間中的所有頻道 | 最高,覆蓋頻道和個人設定 |
| Channel | 頻道擁有者在頻道中輸入 config,並選擇 儲存為整個頻道的設定 |
該頻道的所有成員 | 覆寫個人設定 |
| 個人 | 個別使用者在頻道中傳送 config |
該使用者在頻道中的 @Databricks Genie 提及內容 |
當未設定全通道配置時使用 |
工作區管理員設定
從設定>安全>外部存取,工作空間管理員控制 Microsoft Teams 中的 Databricks Genie 應用程式是否能連接工作區,以及其回應是否可以公開:
- 允許的協作平台:哪些協作平台可以連接到工作空間。 選擇 「全部允許」(預設)、只允許 Slack、只允許 Teams 或 全部拒絕。 當 Microsoft Teams 不被允許時,使用者無法將應用程式連接到工作區。 已經連線的使用者會收到私訊,告知不允許連線至該工作區,並被要求更改工作區或聯絡工作區管理員。
- 允許在協作平台公開訊息:開啟時,用戶與頻道擁有者可選擇回應是公開還是私密。 關閉時,回覆只會對提問的使用者可見。
這些設定的變更可能需要長達一小時才能生效。
資料路由
Genie 會在你的工作區處理你的問題,並將對話歷史儲存在你工作區所在區域。 Microsoft Teams 與你的工作空間之間的請求會經過 Azure Databricks 控制平面中的中央 Azure Databricks 服務。 中央服務在 East US 2 區域運行,無論您的工作區位於哪個區域。 中央服務不會保存或記錄任何請求或回應內容。 它只儲存 Microsoft Teams 租戶與 Azure Databricks 工作空間之間的對應。
Microsoft Teams 需要固定端點來接收請求,因此該應用程式使用中央服務。
當你在 Microsoft Teams 中提出問題時:
- Microsoft Teams 會將您的問題傳送到中央服務。
- 中央服務會將請求轉發到你的 Azure Databricks 工作空間。
- Genie 會處理這個請求並在你的工作區產生答案。
- 答案會透過中央服務回到 Microsoft Teams。
當你將文件儲存為 PDF 時,應用程式會從你的工作區下載該 PDF,並透過 East US 2 將其上傳到你的 OneDrive。 這個應用程式不儲存 PDF。
LLM 處理發生的地方
中央服務會在 Microsoft Teams 與你的工作空間之間路由訊息。 你工作區中的 Genie 會呼叫大型語言模型(LLM),因此你工作區的 Geo 及其 跨 Geo 處理 設定決定 LLM 在哪裡處理你的內容。 舉例來說,如果你的工作區位於歐洲地理區域且未啟用跨地理處理,LLM 會在歐洲處理你的內容。 請參閱 Databricks 指定的服務。
搭配 Private Link 工作區使用
Microsoft Teams 中的 Databricks Genie 應用程式可支援使用前端 Private Link 的工作空間。 Microsoft Teams 不支援外發的 Private Link 連線,因此該應用程式不會透過 Private Link 連線。 相反地,你加入一條基於情境的傳入規則,讓只有應用程式能存取你工作區的 Genie API。 這條規則不會改變你的原則如何處理其他流量,每個請求都會以提出要求的使用者權限執行。
您必須是帳戶管理員才能完成這些步驟。 在啟用公開存取之前,先建立輸入原則,這樣工作區在任何時候都不會接受無限制的公用流量。
步驟 1:為應用程式建立 Ingress 原則
基於情境的入口政策會根據每個請求的身份、請求類型及網路來源,控制哪些請求能到達你的工作空間。 請參閱 環境定義型輸入控制。
- 在帳號主控台中,開啟或建立你工作區的網路政策。 請參閱 Access 網路政策。
- 在 Ingress 索引標籤上,於 公用網路存取 下方,確認已清除 「允許所有公用 IP 存取」。 公開請求則會被拒絕,除非符合允許規則。
- 新增一個 允許 規則,並使用下列設定:
- 存取類型: API,具有 Genie API 範圍。
- 身分:所有使用者與服務主體,或 選取的身分,以限制哪些身分可以使用該應用程式。
- 資料來源: 合作夥伴平台>Databricks Teams 應用程式。 參見 「允許合作夥伴平台用於情境式入口政策」
- 儲存該政策並附加到你的工作區。 請參見「將政策附加到工作區」。 變更可能需要長達30分鐘才能生效。
步驟二:啟用工作區的公開存取權限
當公共存取被停用時,所有公開請求,包括應用程式請求,都會在評估入口政策前被封鎖。 啟用公共存取並不代表工作空間對所有公共流量開放。 第一步的入口政策仍會評估每個公開請求,且只允許符合允許規則的請求。 你現有的私有端點不會改變。
在 Azure 入口網站中,開啟工作區,然後按一下 設定>網路功能。 在 網路存取 標籤中,將 允許公共網路存取 設為 啟用。 請參見 「驗證啟用公開存取的 VNet 注入工作區」。
確認設定
政策生效後,請確認工作區仍封鎖其他公開流量,且應用程式能存取該工作區:
- 斷開你的 VPN 或其他會路由到私人端點的網路,這樣你的瀏覽器才能透過公共網際網路連線。
- 打開你的工作區網址。 除非政策中有其他允許規則涵蓋你的網路,否則存取權限會被拒絕。
- 在 Microsoft Teams 裡,提及
@Databricks Genie並提出問題。 應用程式會回傳一個答案。
要審查被拒絕的請求,請查詢 system.access.inbound_network 系統資料表,該表記錄了輸入政策拒絕的入站請求。 步驟 2 中被拒絕的瀏覽器請求顯示在那裡。 如果應用程式無法連上你的工作區,表格會顯示是哪條規則拒絕了它的請求。 紀錄通常一小時內可取得。 請參閱 入站網路存取事件系統資料表結構。
透過稽核日誌監控使用情況
帳號與工作區管理員可以使用稽核日誌系統表(system.access.audit)來監控來自 Microsoft Teams 的 Genie 使用情況。 當使用者透過 Microsoft Teams 中的 Databricks Genie 應用程式發送訊息時,Genie One 會記錄createGenieChatResponse該服務下的genieChat事件,欄位request_params.source記錄teams為來源。 這可讓你區分來自 Microsoft Teams 的請求,以及在 Azure Databricks 網頁 UI(webapp)中提出或透過其他整合(例如 Slack(slack))提出的請求。
以下範例查詢回傳過去 5 天內由 Microsoft Teams 發起的 Genie 請求,包括詢問的使用者及對話 ID:
SELECT
event_time,
user_identity.email AS user_email,
request_params.conversation_id AS conversation_id
FROM system.access.audit
WHERE service_name = 'genieChat'
AND action_name = 'createGenieChatResponse'
AND request_params.source = 'teams'
AND event_date >= date_add(current_date(), -5)
ORDER BY event_time DESC
關於稽核日誌表架構及更多範例查詢,請參閱稽核日誌系統資料表參考。 欲了解 Genie One 聊天活動的完整列表,請參見 Genie One 中的聊天活動。
Microsoft 上必須的應用程式權限
當你在 Microsoft Teams 安裝 Databricks Genie 應用程式時,它會要求以下權限。 Entra ID 權限是涵蓋整個租用戶的 Microsoft Graph 權限,由 Microsoft 365 系統管理員代表您的組織授與同意。 資源專屬 權限是 Teams 資源專屬同意(RSC)權限,僅適用於安裝該應用程式的聊天室、頻道或團隊。
欲了解更多關於這些權限的資訊,請參閱 Microsoft 文件中的資源專屬同意與圖譜權限。
| 許可 | Description | 類型 |
|---|---|---|
offline_access |
保持你授權它存取的資料存取權。 | Entra ID (Entra 身份識別) |
User.Read |
登入並閱讀使用者資料。 | Entra ID (Entra 身份識別) |
ChatMessage.Read.Chat |
請閱讀這個聊天室的訊息。 | 資源特定 |
ChatMessage.Send.Chat |
把訊息傳到這個聊天室。 | 資源特定 |
TeamsActivity.Send.Chat |
在本聊天室用戶的團隊活動動態中建立新通知。 | 資源特定 |
TeamsActivity.Send.User |
向此使用者發送活動動態通知。 | 資源特定 |
ChannelMember.Read.Group |
讀取團隊中各頻道的成員。 | 資源特定 |
ChannelMessage.Read.Group |
閱讀這支隊伍的頻道訊息。 | 資源特定 |
ChannelSettings.Read.Group |
閱讀這支隊伍的頻道名稱、說明和設定。 | 資源特定 |
Troubleshooting
登入時出現「需要管理員批准」訊息
當你登入 Azure Databricks 工作空間時,會出現以下「需要管理員批准」訊息,因為 Microsoft Entra 租戶正在阻擋 Azure Databricks 應用程式的使用者同意。 若未獲得管理員同意,Microsoft Entra ID 仍會繼續阻擋登入流程,即使你有直接工作區存取權。
為解決此問題,具備適當管理員角色的 Microsoft Entra 使用者必須授權租戶管理員同意 Azure Databricks 企業應用程式。
請請 Microsoft Entra 管理員點選以下連結。 請用你的 Microsoft Entra 租戶 ID 替換{TENANT_ID}:
https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b
若連結失敗,管理員可手動授權:
- 在 Microsoft Entra 系統管理中心,前往 Entra ID>Enterprise apps>All Applications,找到用於單一登入的Azure Databricks企業應用程式。 要識別應用程式,請搜尋應用程式 ID
aaec40b0-c0ae-4211-a98b-6fc160abb71b。 - 請授予 Azure Databricks 企業應用程式所請求的權限管理員同意:
- 在 安全性下,點選 權限。
- 點選 授予管理員同意。
詳細說明請參閱 Microsoft 文件。
Limitations
- 你無法指定 Microsoft Teams 中 Databricks Genie 應用程式使用的是哪個運算(SQL 倉庫)。 Azure Databricks 會自動選擇使用者有權限存取的 SQL 倉庫。
- 在 Genie One 開始的對話,在 Genie Agent 已釘選後仍保留在 Genie One。 只有新對話會交給已釘選的代理程式。
- 檔案上傳僅支援在沒有置頂 Genie Agent 的私訊中。 在頻道、群組聊天和 Microsoft 365 Copilot 中,Genie 不會回覆包含附件的訊息。 反而回覆說上傳功能只能在私訊中使用。 在與置頂的 Genie Agent 對話中,它回覆說與 Genie Agent 的對話中不支援上傳檔案。
- 檔案上傳僅支援 20 MiB 以下的 PDF、Word(
.docx)及 CSV 檔案,每則訊息最多可上傳五個檔案。 - 儲存文件為 PDF 僅可在私訊中使用。 Genie 不支援在頻道、群組聊天或 Microsoft 365 Copilot 中使用 PDF。 OneDrive 及 Microsoft Teams 中 Databricks Genie 應用程式 1.0.17 及以上版本是必須的。 超過 20 MiB 的 PDF 無法儲存。