> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/tech/authorization-integration.md).

# 權限整合

- [軟體廠商整合指南（端到端）](https://docs.maiagent.ai/tech/authorization-integration/vendor-integration-guide.md): 軟體廠商將 Web Chat 嵌入自家產品並完成權限對接的端到端指南：嵌入、批次補建、登入同步、Token 刷新與登出註銷
- [聯絡人 (Contact) 介紹及串接](https://docs.maiagent.ai/tech/authorization-integration/contacts.md)
- [聯絡人身份同步與 Token 更新](https://docs.maiagent.ai/tech/authorization-integration/contact-credentials-sync.md): 企業系統在新增使用者與每次登入時，透過 setup-contact-credentials 同步聯絡人身份與更新 Token 憑證
- [角色(Role) 和 聯絡人(Contact) 的差異](https://docs.maiagent.ai/tech/authorization-integration/role-vs-contact.md): 內部成員用角色（Role）管理平台權限，外部使用者用聯絡人（Contact）識別身份——兩者的定義、差異與選擇方式
- [知識管理權限(Query Metadata / 查詢元資料) 總覽](https://docs.maiagent.ai/tech/authorization-integration/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan.md): 透過 Query Metadata（查詢元資料）控管 AI 助理可檢索的知識範圍，詳細設定方式見「開始建構」子頁
- [開始建構—使用「查詢構建器」](https://docs.maiagent.ai/tech/authorization-integration/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan/graphical-interface.md): 用後台的「查詢構建器」以勾選方式設定 Query Metadata，涵蓋聯絡人層級與內部問答的逐訊息設定
- [開始建構—使用 JSON 格式](https://docs.maiagent.ai/tech/authorization-integration/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan/json-interfaces.md): 若您想要撰寫更複雜的篩選條件，可使用 JSON 格式直接以各層級 (如知識庫、單一文件等) ID 指定


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/tech/authorization-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.