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

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--analyzer -a

分析儀名稱;預設使用已設定的預設分析器。

--api-key

Microsoft Foundry 資源 API 金鑰。

--api-version

內容理解服務 API 版本。

--auth-mode

認證模式。

屬性 值
接受的值: key, login
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--concurrency -j

同時進行分析工作。

屬性 值
預設值: 4
--dry-run

顯示本地執行計畫,無需服務呼叫或寫入。

屬性 值
預設值: False
--endpoint

Microsoft Foundry 內容理解資源端點。

--file

字面上的本地檔案。 重複這個步驟,針對多個檔案。

--inline -i

使用預覽同步分析。

屬性 值
預設值: False
--llm-input

回傳分析結果,格式化為生成式 AI 模型輸入。

屬性 值
預設值: False
--on-existing

如何處理現有的結果檔案。

屬性 值
接受的值: error, reanalyze, skip
--output-dir -d

在此目錄下寫入結果,保留來源相對路徑。

--output-file

寫入一個選定檔案的主要有效載荷。

--pattern

Python fnmatch 模式套用到每個 --來源。

--profile

CU CLI 配置檔用於解析端點與 API 版本預設值。

--recursive -r

遞迴到指定的目錄。

屬性 值
預設值: False
--report-file

寫一份獨立的 JSON 狀態報告。

--source

本地來源目錄。 重複多個目錄。

--url

HTTPS 或 Azure Blob SAS URL。 重複這個步驟,針對多個網址。

--usage

請包含服務使用細節。

屬性 值
預設值: False
--yes -y

跳過證據開示確認。

屬性 值
預設值: False
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --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

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--api-key

覆蓋已設定的 API 金鑰。

--api-version

內容理解 API 版本。 已知版本:2025-11-01(通用版)及2026-06-01預覽(預覽);任何 YYYY-MM-DD-PREVIEW 版本也都被接受。

--auth-mode

認證模式;預設為所選的 CU CLI 設定檔。

屬性 值
接受的值: key, login
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--endpoint

覆寫已設定的 Microsoft Foundry 資源端點。

--fix-defaults

設定內容理解從個人檔案模型映射中取得的預設值。

屬性 值
預設值: False
--profile -p

命名為 CU CLI 設定檔。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False