# AI 圖片理解欄位
## 一、功能簡介
**AI 圖片理解**欄位能夠利用大模型強大的視覺識別能力，自動讀取並分析表單中上傳的圖片內容，再根據您設定的要求提取資訊或進行判斷，最終將結果展示在對應的文字或富文本欄位中。
此功能特別適用於需要對圖片進行快速檢驗或資訊提取的場景。例如：在巡檢業務中，自動識別現場拍攝的照片是否乾淨整潔；在報銷流程中，自動讀取發票圖片上的金額與日期；或在設備維護中，識別設備儀表板上的讀數。這不僅省去了人工查看圖片的繁瑣步驟，還大幅提升了資料錄入的效率與準確性。
> **支援理解的欄位類型**：圖片欄位、附件欄位（系統只會處理附件中的圖片類型檔案）。
## 二、操作流程
### 進入欄位配置介面
1. 進入目標應用的表單設計介面。
2. 點擊左側導航欄中的 **AI 場景**頁籤。
3. 將 **AI 圖片理解**欄位拖曳至表單設計區域中，右側即會彈出欄位屬性面板。
### 配置 AI 圖片理解欄位
在屬性面板中，您需要完成以下配置：
| 屬性名稱 | 說明 |
| ------------ | ------------------------------------------------------ |
| **欄位名稱** | 預設為「AI 圖片理解」，必填，長度限制為 255 個字元 |
| **選擇欄位類型** | 可選「文字」或「富文本」，預設為「文字」 |
| **選擇模式** | 欄位類型為「文字」時顯示，可選「單行」或「多行」，預設為「單行」 |
| **需要理解的欄位** | 單選，必填。選擇包含目標圖片的來源欄位 |
| **請輸入要求/提示** | 必填，向 AI 說明需要從圖片中識別什麼內容或如何評價（最多 3000 個字元）。支援插入表單其他欄位的變數 |
| **禁止手動輸入** | 開啟後欄位鎖定為唯讀，確保識別結果的客觀性，預設不開啟 |
| **欄位權限** | 可見、可編輯、新建記錄時隱藏，與現有控制項一致 |
| **欄位寬度** | 可定義控制項在表單頁面的寬度，與現有控制項一致 |
**撰寫提示詞的建議**：在「請輸入要求/提示」中，指令越具體，AI 的識別結果越準確。例如，與其只寫「檢查衛生」，不如寫成：「識別圖片中的內容，評價打掃效果，只能輸出『乾淨』或『存在污漬』」。
### 實際運行效果
配置完成後，在表單記錄的填寫或編輯過程中，當使用者上傳了圖片後，聚焦 AI 圖片理解欄位並點擊 AI 輸入按鈕，即可觸發識別。
以衛生巡檢場景為例：巡檢人員在「打掃圖片」欄位上傳了一張電梯內部的照片。根據配置的提示要求（識別圖片內容並評價打掃效果），**AI 圖片理解**欄位會自動分析照片，並精準輸出評價結果：「乾淨」。整個過程快速且客觀。
## 三、常見問題
如果「需要理解的欄位」中上傳了多張圖片，AI 會如何處理？
AI 會綜合分析該欄位中上傳的所有圖片內容，並根據您的提示詞給出整體的理解與回覆。建議在提示詞中明確說明多圖情況下的處理邏輯（例如：「綜合分析所有圖片，若有任何一張存在污漬則輸出『存在污漬』」）。
AI 圖片理解支援哪些圖片格式？
支援常見的圖片格式（如 JPG、PNG 等）。若是透過附件欄位上傳，系統會自動過濾並只處理其中的圖片檔案。
歷史記錄如何批量執行 AI 圖片理解？
歷史記錄需透過「批量刷新」手動觸發。請注意，同一租戶每分鐘請求 AI 欄位不超過 100 個，超出限制時需稍作等待。
---
# 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.yoov.com/yoov-plus/worksheet/worksheet-design/ai-chang-jing-zi-duan/ai-tu-pian-li-jie-lan-wei.md?ask=
```
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.