> 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/serve/contacts/role-vs-contact.md).

# 角色(Role) 和 聯絡人(Contact) 的差異

內部成員用角色（Role）管理平台權限，外部使用者用聯絡人（Contact）識別身分；完整對照見使用者手冊

MaiAgent 中有兩種「人」：**成員（Member）** 登入 MaiAgent 後台操作，權限由**角色（Role）** 決定；**聯絡人（Contact）** 是跟 Agent 對話的終端使用者，不需要 MaiAgent 帳號，對話歷史、自訂屬性、知識查詢範圍（`query_metadata`）與工具憑證都掛在聯絡人上。串接對外服務時用聯絡人，對內發放平台權限時用角色，兩者各走各的機制。

定義、差異對照與選擇方式，見使用者手冊[角色和聯絡人的差異](https://docs.maiagent.ai/org/roles/contact-role-comparison)；聯絡人的 API 串接見[聯絡人 (Contact) 介紹及串接](/tech/serve/contacts.md)，知識範圍的設定見[知識管理權限（Query Metadata）](/tech/identity-and-access/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan.md)。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/tech/serve/contacts/role-vs-contact.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.