# 個人資料：自訂屬性

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

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

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

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

***

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

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

頁面分為兩個區塊：

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

<figure><img src="/files/uqETX5Xw3bmiYWC2OhrP" alt=""><figcaption><p>個人資料頁面 — 下方為自訂屬性區塊</p></figcaption></figure>

***

## 新增自訂屬性 <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> 按鈕，會新增一列空白的編輯列。

<figure><img src="/files/k6jAdFfnpwHzfwTg1K0M" alt=""><figcaption><p>新增屬性 — 顯示編輯欄位</p></figcaption></figure>

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

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

<figure><img src="/files/yUoern16YnkrucvbDmwP" alt=""><figcaption><p>填寫屬性名稱與值</p></figcaption></figure>

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

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

<figure><img src="/files/4CH6VOq1tcOlPSahhRvt" alt=""><figcaption><p>屬性新增完成，顯示在列表中</p></figcaption></figure>

{% 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 串接。

<figure><img src="/files/bsjAHSysHoVY5dZ0vCCt" alt=""><figcaption><p>JSON 預覽 — 檢視屬性的結構化資料</p></figcaption></figure>

***

## 編輯與刪除屬性 <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> 圖示，系統會彈出確認對話框。確認刪除後，該屬性會從列表中移除。

<figure><img src="/files/a9PkBcOlefVdIrmsjhHz" alt=""><figcaption><p>刪除屬性確認對話框</p></figcaption></figure>

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


---

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