# 連接器

連接器讓 MaiGPT 能夠存取你的第三方工具，例如 Notion、Slack、Google Drive、GitHub。連接後，你可以直接在對話中查詢和操作這些工具裡的資料。

***

## 可以連接哪些工具 <a href="#supported-tools" id="supported-tools"></a>

| 工具               | 連接後你可以做什麼                        |
| ---------------- | -------------------------------- |
| **Notion**       | 搜尋頁面、查詢資料庫、建立新頁面                 |
| **Slack**        | 搜尋訊息、查看頻道內容                      |
| **Google Drive** | 搜尋和讀取文件                          |
| **GitHub**       | 查看 Repository、Issue、Pull Request |

{% hint style="info" %}
可用的連接器由公司管理員設定。如果你需要使用的工具不在列表中，請聯繫管理員。
{% endhint %}

***

## 怎麼連接 <a href="#how-to-connect" id="how-to-connect"></a>

### 1. 開啟連接器設定 <a href="#open-connector-settings" id="open-connector-settings"></a>

點擊對話介面中的工具圖示，找到連接器區域。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-bb0d193975f936714b61e3ecb6c4f7d13683ee3e%2Fmaigpt-connectors-panel.png?alt=media" alt="MaiGPT 連接器面板"><figcaption><p>點擊「連接器」按鈕即可看到可用的連接器清單</p></figcaption></figure>

### 2. 授權你的帳號 <a href="#authorize-account" id="authorize-account"></a>

選擇要連接的工具，點擊「連接」後會跳轉到該工具的授權頁面。按照提示完成授權即可。

### 3. 開始使用 <a href="#start-using" id="start-using"></a>

連接成功後，直接在對話中提問：

> 「搜尋 Notion 裡關於 Q1 計畫的頁面」
>
> 「查一下 Google Drive 裡的報價單」

***

## 管理已連接的工具 <a href="#manage-connected-tools" id="manage-connected-tools"></a>

你可以隨時在連接器設定中：

* **查看** — 目前已連接的工具
* **斷開** — 取消某個工具的連接
* **重新授權** — 如果連接失效，重新授權

***

## Notion <a href="#notion" id="notion"></a>

連接 Notion 後，你可以在 MaiGPT 中直接搜尋 Notion 頁面、查詢資料庫、甚至建立新頁面。

### 連接步驟 <a href="#notion-connection-steps" id="notion-connection-steps"></a>

1. 開啟連接器設定，找到 Notion
2. 點擊「連接」，跳轉到 Notion 授權頁面
3. 選擇你要授權 MaiGPT 存取的頁面或工作區
4. 點擊「允許」完成授權

### 可以做什麼 <a href="#notion-what-you-can-do" id="notion-what-you-can-do"></a>

連接後，在對話中直接說：

| 你說                         | MaiGPT 做     |
| -------------------------- | ------------ |
| 「搜尋 Notion 裡關於產品規格的頁面」     | 搜尋並列出相關頁面    |
| 「查一下 Notion 專案資料庫中未完成的任務」  | 查詢資料庫並篩選     |
| 「在 Notion 建立一個新頁面，標題是會議紀錄」 | 建立新頁面        |
| 「把這份摘要存到 Notion」           | 將內容寫入 Notion |

### 注意事項 <a href="#notion-notes" id="notion-notes"></a>

{% hint style="warning" %}
**授權範圍**

Notion 授權時可以選擇分享哪些頁面給 MaiGPT。只有你授權的頁面才能被搜尋到。如果找不到某個頁面，請確認是否已授權。
{% endhint %}

***

## Slack <a href="#slack" id="slack"></a>

連接 Slack 後，你可以在 MaiGPT 中搜尋 Slack 訊息和頻道內容，快速找到之前的討論。

### 連接步驟 <a href="#slack-connection-steps" id="slack-connection-steps"></a>

1. 開啟連接器設定，找到 Slack
2. 點擊「連接」，跳轉到 Slack 授權頁面
3. 確認授權範圍後，點擊「允許」

### 可以做什麼 <a href="#slack-what-you-can-do" id="slack-what-you-can-do"></a>

| 你說                      | MaiGPT 做 |
| ----------------------- | -------- |
| 「搜尋 Slack 裡關於伺服器遷移的討論」  | 搜尋相關訊息   |
| 「查一下 #general 頻道最近在聊什麼」 | 摘要頻道內容   |
| 「找一下 John 上週提到的那個連結」    | 搜尋特定人的訊息 |

***

## Google Drive <a href="#google-drive" id="google-drive"></a>

連接 Google Drive 後，你可以在 MaiGPT 中搜尋和讀取你的 Google Drive 文件。

### 連接步驟 <a href="#google-drive-connection-steps" id="google-drive-connection-steps"></a>

1. 開啟連接器設定，找到 Google Drive
2. 點擊「連接」，跳轉到 Google 授權頁面
3. 選擇你的 Google 帳號並允許存取

### 可以做什麼 <a href="#google-drive-what-you-can-do" id="google-drive-what-you-can-do"></a>

| 你說                      | MaiGPT 做  |
| ----------------------- | --------- |
| 「搜尋 Google Drive 裡的報價單」 | 搜尋並列出相關文件 |
| 「打開上次的會議紀錄」             | 找到並讀取文件內容 |
| 「幫我摘要 Drive 裡那份市場分析報告」  | 讀取文件並產出摘要 |

***

## GitHub <a href="#github" id="github"></a>

連接 GitHub 後，你可以在 MaiGPT 中查詢 Repository、Issue、Pull Request 等開發相關資訊。

### 連接步驟 <a href="#github-connection-steps" id="github-connection-steps"></a>

1. 開啟連接器設定，找到 GitHub
2. 點擊「連接」，跳轉到 GitHub 授權頁面
3. 選擇要授權的 Repository 並確認

### 可以做什麼 <a href="#github-what-you-can-do" id="github-what-you-can-do"></a>

| 你說                                 | MaiGPT 做    |
| ---------------------------------- | ----------- |
| 「查一下 main-repo 最近有哪些 open 的 Issue」 | 列出 Issue 清單 |
| 「幫我看 PR #123 的變更摘要」                | 讀取 PR 並摘要   |
| 「搜尋 repo 裡跟 authentication 相關的程式碼」 | 搜尋程式碼       |

***

## 下一步 <a href="#next-steps" id="next-steps"></a>

* [管理存取權限](https://docs.maiagent.ai/maigpt/access)
* [回到 MaiGPT 總覽](https://docs.maiagent.ai/maigpt/maigpt)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maiagent.ai/maigpt/connectors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.