> 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/org/overview/custom-attributes.md).

# 個人資料：自訂屬性

在個人資料中新增自訂屬性，記錄部門、職稱、分機號碼等額外資訊

## 功能說明 <a href="#feature-description" id="feature-description"></a>

自訂屬性讓您在個人資料中記錄額外的資訊，例如部門、職稱、分機號碼、員工編號等。這些資訊會儲存在您的個人資料中，方便組織內部識別與管理。

您可以透過以下方式管理自訂屬性：

* **手動新增**：逐筆輸入屬性名稱與值
* **Excel 匯入**：批量匯入多筆屬性
* **JSON 預覽**：檢視屬性的結構化資料格式

組織管理員也可以替成員設定，見 [管理員代為設定](#admin-edit-member-metadata)；人數多時可用 [批次匯入成員 Metadata](/org/overview/member.md#batch-import-members-metadata) 整批寫入。

***

## 進入個人資料 <a href="#enter-profile" id="enter-profile"></a>

點擊右上角的頭像或名稱，選擇 <mark style="color:blue;">個人資料</mark>，即可進入個人資料頁面。

頁面分為兩個區塊：

* **個人資料**：姓名、公司名稱、公司信箱等基本資訊
* **自訂屬性**：自訂的額外個人資訊

***

## 新增自訂屬性 <a href="#add-custom-attribute" id="add-custom-attribute"></a>

### 1. 點擊新增屬性 <a href="#step-1-click-add" id="step-1-click-add"></a>

在自訂屬性區塊中，點擊 <mark style="color:blue;">+ 新增屬性</mark> 按鈕，會新增一列空白的編輯列。

### 2. 填寫屬性名稱與值 <a href="#step-2-fill-name-and-value" id="step-2-fill-name-and-value"></a>

| 欄位       | 說明                               |
| -------- | -------------------------------- |
| **屬性名稱** | 屬性的名稱，例如「部門」、「職稱」、「分機」（必填，不可重複）  |
| **值**    | 屬性的內容，例如「產品開發部」、「工程師」、「1234」（必填） |

### 3. 確認並儲存 <a href="#step-3-confirm-and-save" id="step-3-confirm-and-save"></a>

填寫完成後，點擊 ✓ 按鈕確認該筆屬性，再點擊頁面下方的 <mark style="color:blue;">儲存</mark> 按鈕將變更寫入系統。

{% hint style="info" %}
屬性名稱在同一個人資料中不可重複。如需修改屬性名稱或值，請點擊該筆屬性的編輯圖示。
{% endhint %}

***

## 批量匯入（Excel） <a href="#bulk-import-excel" id="bulk-import-excel"></a>

若需要一次匯入多筆屬性，可使用 Excel 匯入功能：

1. 點擊 <mark style="color:blue;">下載範本</mark> 取得 Excel 範本檔案
2. 在範本中填寫屬性名稱與值（每列一筆）
3. 點擊 <mark style="color:blue;">匯入 Excel</mark> 上傳填寫好的檔案
4. 系統會自動解析並匯入所有屬性

***

## JSON 預覽 <a href="#json-preview" id="json-preview"></a>

點擊 <mark style="color:blue;">JSON 預覽</mark> 可展開檢視屬性的結構化 JSON 格式，方便開發人員確認資料格式或用於 API 串接。

***

## 編輯與刪除屬性 <a href="#edit-and-delete-attribute" id="edit-and-delete-attribute"></a>

### 編輯 <a href="#edit" id="edit"></a>

點擊該筆屬性右側的 <mark style="color:blue;">編輯</mark> 圖示，即可修改屬性名稱或值。修改完成後點擊 ✓ 確認，再點擊 <mark style="color:blue;">儲存</mark>。

### 刪除 <a href="#delete" id="delete"></a>

點擊該筆屬性右側的 <mark style="color:blue;">刪除</mark> 圖示，系統會彈出確認對話框。確認刪除後，該屬性會從列表中移除。

{% hint style="warning" %}
刪除屬性後需點擊 <mark style="color:blue;">儲存</mark> 才會真正生效。若未儲存就離開頁面，變更將不會保留。
{% endhint %}

***

## 管理員代為設定 <a href="#admin-edit-member-metadata" id="admin-edit-member-metadata"></a>

成員沒空自己填、或公司要統一維護部門與職稱時，具備「組織概覽權限」的管理員可以在成員管理頁替任一位成員（包含自己）設定個人偏好與自訂屬性：

1. 從左側選單點擊 <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概覽</mark>，在 <mark style="color:blue;">管理操作</mark> 點 <mark style="color:blue;">編輯成員</mark>
2. 在 <mark style="color:blue;">成員列表</mark> 找到該成員，點操作欄的 <mark style="color:blue;">編輯成員資訊</mark> 圖示
3. 視窗最上方是成員在本組織的 <mark style="color:blue;">名稱</mark>（只有組織擁有者可以修改，見 [修改成員名稱](/org/overview/member.md#edit-member-name)），下方分成兩塊，改完按 <mark style="color:blue;">確認</mark> 即寫入，不需另外按儲存：

| 區塊                                    | 說明                                                                                                                                                                                    |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">個人偏好</mark> | 一段描述成員習慣與常用情境的文字（最多 1,000 字），AI 互動時會參考，和成員在 [個人帳號設定](/start/profile.md#preference-and-attributes) 填的是同一欄                                                                              |
| <mark style="color:blue;">自訂屬性</mark> | 與個人資料頁相同的編輯器：<mark style="color:blue;">+ 新增屬性</mark>、<mark style="color:blue;">下載範本</mark>／<mark style="color:blue;">匯入 Excel</mark>、<mark style="color:blue;">JSON 預覽</mark>、逐筆編輯與刪除 |

{% hint style="info" %}
管理員改的和成員自己改的是同一份資料，後存檔的會覆蓋先前的內容。這份資料記在成員在**這個組織**的成員資料上，成員切換到其他組織時看到的是另一份。
{% endhint %}


---

# 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/org/overview/custom-attributes.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.