az cu
Note
此參考文獻是 Azure CLI(版本 2.75.0 或更高版本)的內容理解擴充的一部分。 這個擴充功能會在你第一次執行 az cu 指令時自動安裝。 深入了解擴充功能。
此命令群組處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
管理並使用 Azure 內容理解。
命令
| 名稱 | Description | 類型 | 狀態 |
|---|---|---|---|
| az cu analyze |
處理本地檔案或 HTTPS URL,並回傳分析結果。 |
Extension | Preview |
| az cu analyzer |
管理內容理解分析器。 |
Extension | Preview |
| az cu analyzer copy |
在 Microsoft Foundry 資源內或跨資源複製分析器。 |
Extension | Preview |
| az cu analyzer create |
從 JSON 架構檔案建立分析器。 |
Extension | Preview |
| az cu analyzer delete |
刪除分析儀。 |
Extension | Preview |
| az cu analyzer list |
Microsoft Foundry 資源中的清單分析器。 |
Extension | Preview |
| az cu analyzer schema |
作者內容理解分析器結構。 |
Extension | Preview |
| az cu analyzer schema create |
建立一個入門架構,或從本地文件範例中推導出一個。 |
Extension | Preview |
| az cu analyzer show |
顯示單一分析器定義(JSON)。 |
Extension | Preview |
| az cu analyzer test |
用分析儀掃描當地樣本。 |
Extension | Preview |
| az cu analyzer validate |
驗證本地分析器架構。 |
Extension | Preview |
| az cu defaults |
管理內容 了解模型部署的預設值。 |
Extension | Preview |
| az cu defaults set |
設定內容理解的預設值,將模型映射到部署。 |
Extension | Preview |
| az cu defaults show |
顯示內容理解的預設值,將模型映射到部署。 |
Extension | Preview |
| az cu doctor |
確認 Microsoft Foundry 資源連線與內容理解的預設值。 |
Extension | Preview |
| az cu env-var |
安全檢查已識別的 CU 環境變數名稱。 |
Extension | Preview |
| az cu env-var list |
列出目前已設定的已識別環境變數。 |
Extension | Preview |
| az cu infra |
生成基礎設施即程式碼以促進內容理解。 |
Extension | Preview |
| az cu infra _models |
為產生的基礎架構專案配置模型部署。 |
Extension | Preview |
| az cu infra _postprovision-v1 |
azd 配置後完成生成專案設定。 |
Extension | Preview |
| az cu infra generate |
產生一個 azd/Bicep 專案用於內容理解。 |
Extension | Preview |
| az cu profile |
管理 Azure CLI 配置中原子儲存的 CU 設定檔。 |
Extension | Preview |
| az cu profile copy |
將 CU CLI 設定檔複製到新名稱。 |
Extension | Preview |
| az cu profile create |
建立一個空的命名 CU CLI 設定檔,但不啟用它。 |
Extension | Preview |
| az cu profile delete |
刪除一個已停用的 CU CLI 設定檔。 |
Extension | Preview |
| az cu profile get |
列印一個已儲存的 CU CLI 設定檔值。 |
Extension | Preview |
| az cu profile list |
列出已儲存的 CU CLI 設定檔,並識別活躍的 CU CLI 設定檔。 |
Extension | Preview |
| az cu profile rename |
重新命名 CU CLI 配置檔,同時保留其值與活動狀態。 |
Extension | Preview |
| az cu profile set |
設定一個儲存的 CU CLI 設定檔值。 |
Extension | Preview |
| az cu profile set-active |
選擇啟用的 CU CLI 設定檔。 |
Extension | Preview |
| az cu profile show |
顯示有效的 CU CLI 配置檔,並刪除秘密。 |
Extension | Preview |
| az cu profile sync-defaults |
從內容理解的預設值中刷新個人檔案的模型映射。 |
Extension | Preview |
| az cu profile unset |
移除一個明確儲存的 CU CLI 設定檔值。 |
Extension | Preview |
az cu analyze
指揮組 'cu' 目前處於預覽階段並正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
處理本地檔案或 HTTPS URL,並回傳分析結果。
az cu analyze [--acquire-policy-token]
[--analyzer]
[--api-key]
[--api-version]
[--auth-mode {key, login}]
[--change-reference]
[--concurrency]
[--dry-run]
[--endpoint]
[--file]
[--inline]
[--llm-input]
[--on-existing {error, reanalyze, skip}]
[--output-dir]
[--output-file]
[--pattern]
[--profile]
[--recursive]
[--report-file]
[--source]
[--url]
[--usage]
[--yes]
範例
用明確的分析器和端點分析發票。
az cu analyze --file invoice.pdf --analyzer prebuilt-invoice --endpoint https://contoso.services.ai.azure.com/
利用啟用 CU 設定檔的預設值分析檔案。
az cu analyze --file invoice.pdf
使用 JMESPath 選取擷取欄位。
az cu analyze --file invoice.pdf --query "contents[0].fields"
分析一個 HTTPS 或 Azure Blob SAS URL。
az cu analyze --url "https://storage.example/container/invoice.pdf?<sas>" --analyzer prebuilt-invoice
遞迴分析目錄,並將結果寫入同一個目錄。
az cu analyze --source documents --recursive --output-dir results --analyzer prebuilt-document --yes
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
分析儀名稱;預設使用已設定的預設分析器。
Microsoft Foundry 資源 API 金鑰。
內容理解服務 API 版本。
認證模式。
| 屬性 | 值 |
|---|---|
| 接受的值: | key, login |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
同時進行分析工作。
| 屬性 | 值 |
|---|---|
| 預設值: | 4 |
顯示本地執行計畫,無需服務呼叫或寫入。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
Microsoft Foundry 內容理解資源端點。
字面上的本地檔案。 重複這個步驟,針對多個檔案。
使用預覽同步分析。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
回傳分析結果,格式化為生成式 AI 模型輸入。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
如何處理現有的結果檔案。
| 屬性 | 值 |
|---|---|
| 接受的值: | error, reanalyze, skip |
在此目錄下寫入結果,保留來源相對路徑。
寫入一個選定檔案的主要有效載荷。
Python fnmatch 模式套用到每個 --來源。
CU CLI 配置檔用於解析端點與 API 版本預設值。
遞迴到指定的目錄。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
寫一份獨立的 JSON 狀態報告。
本地來源目錄。 重複多個目錄。
HTTPS 或 Azure Blob SAS URL。 重複這個步驟,針對多個網址。
請包含服務使用細節。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
跳過證據開示確認。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
az cu doctor
指揮組 'cu' 目前處於預覽階段並正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
確認 Microsoft Foundry 資源連線與內容理解的預設值。
az cu doctor [--acquire-policy-token]
[--api-key]
[--api-version]
[--auth-mode {key, login}]
[--change-reference]
[--endpoint]
[--fix-defaults]
[--profile]
範例
檢查活躍檔案和資源預設值。
az cu doctor --output table
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
覆蓋已設定的 API 金鑰。
內容理解 API 版本。 已知版本:2025-11-01(通用版)及2026-06-01預覽(預覽);任何 YYYY-MM-DD-PREVIEW 版本也都被接受。
認證模式;預設為所選的 CU CLI 設定檔。
| 屬性 | 值 |
|---|---|
| 接受的值: | key, login |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
覆寫已設定的 Microsoft Foundry 資源端點。
設定內容理解從個人檔案模型映射中取得的預設值。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
命名為 CU CLI 設定檔。
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |