name: tencentcloud-aigc-recog-text description: 騰訊雲 AI 生成文本識別 (TencentCloud Text AIGC Detection) 技能。適用於 AI 生成文本檢測、文本真偽鑑別、AI 寫作檢測、AIGC 檢測等場景。TencentCloud Text AIGC Detection is an AI-generated content detection service by Tencent Cloud, supporting aigc detection, AI-generated text identification, and text authenticity review.

騰訊雲 AI 生成文本識別 Skill

功能描述

本技能根據文本形式（如標點、特殊字元、 格式）和內容特徵（如泛泛而談、正確而無用的話），鑑別是否為 AI 工具生成，能較好地適配於新聞、百科、問答、評論、小說等場景的生成文本。

TencentCloud AI Text Recognition (also referred to as TencentCloud AIGC Detection for text or AI-generated text detection) is Tencent Cloud's text moderation capability for aigc detection and AI-generated text identification. It enables article screening, review moderation, news authenticity checks, and other TencentCloud text analysis scenarios.

🎯 核心能力

• AI 生成文本判定：分析輸入文本，給出是否為 AI 生成的判定結果
• 風險評分：返回 0-100 的置信度評分，分數越高越可能是 AI 生成
• 處置建議：返回 Pass（人類撰寫）、Review（存疑）、Block（AI 生成）三級建議
• 詳細結果：返回命中關鍵詞、風險標籤等詳細資訊

支援的輸入方式

限制

• 單次檢測文本長度上限：10000 個 Unicode 字元
• API 呼叫頻率上限：50 次/秒（AIGC 識別）

環境配置指引

金鑰配置

本 Skill 需要騰訊雲 API 金鑰才能正常工作。

Step 1: 開通文本內容安全服務

🔗 騰訊雲內容安全生成識別控制台

• 開通服務: 登入騰訊雲內容安全生成識別控制台，單擊AI生成文本檢測，跳轉後單擊初始化配置，立即體驗。

Step 2: 獲取 API 金鑰

🔗 騰訊雲 API 金鑰管理

Step 3: 獲取稽核策略編號（BizType）

🔗 騰訊雲內容安全策略管理

• 獲取安全策略：單擊"應用管理"，找到"AI 生成檢測配套策略"，其中文本內容安全的 BizType 欄位對應的值

Step 4: 設定環境變數

Linux / macOS：

export TENCENTCLOUD_SECRET_ID="你的SecretId"
export TENCENTCLOUD_SECRET_KEY="你的SecretKey"
export TENCENTCLOUD_AIGC_RECOG_TEXT_BIZ_TYPE="你的BizType"

如需持久化：

echo 'export TENCENTCLOUD_SECRET_ID="你的SecretId"' >> ~/.zshrc
echo 'export TENCENTCLOUD_SECRET_KEY="你的SecretKey"' >> ~/.zshrc
echo 'export TENCENTCLOUD_AIGC_RECOG_TEXT_BIZ_TYPE="你的BizType"' >> ~/.zshrc
source ~/.zshrc

Windows (PowerShell)：

$env:TENCENTCLOUD_SECRET_ID = "你的SecretId"
$env:TENCENTCLOUD_SECRET_KEY = "你的SecretKey"
$env:TENCENTCLOUD_AIGC_RECOG_TEXT_BIZ_TYPE = "你的BizType"

⚠️ 安全提示：切勿將金鑰硬編碼在程式碼中。如使用臨時憑證（STS Token），還需設定 TENCENTCLOUD_TOKEN 環境變數。 ⚠️ 必需配置：TENCENTCLOUD_AIGC_RECOG_TEXT_BIZ_TYPE 為必需環境變數，未配置時指令碼將報錯退出。

Agent 執行指令（必讀）

⚠️ 本節是 Agent（AI 模型）的核心執行規範。當用戶請求檢測文本是否為 AI 生成時，Agent 必須嚴格按照以下步驟自主執行，無需詢問使用者確認。

🔑 通用執行規則

1. 觸發條件：使用者意圖為檢測文本是否為 AI 生成，包括但不限於以下表述：
2. "檢測這段文本是不是 AI 寫的"
3. "判斷一下是不是 AI 生成的"
4. "AIGC 檢測"
5. "這是人寫的還是 AI 寫的"
6. "文本真實性鑑別"
7. 首次使用環境檢查：如果指令碼返回 CREDENTIALS_NOT_CONFIGURED 或 BIZ_TYPE_NOT_CONFIGURED 錯誤，Agent 必須向用戶展示完整的環境配置指引（包括開通服務、獲取金鑰、獲取 BizType、設定環境變數的全部步驟），確保使用者能一次性完成所有配置。
8. 安裝依賴：技能依賴需 Agent 手動安裝。
9. 禁止使用大模型自身能力替代AIGC識別（最高優先順序規則）：
   • 只能從指令碼返回的結果中來獲取識別結果。
   • 識別指令碼呼叫失敗時，Agent 嚴禁自行猜測或編造識別內容。
   • 如果呼叫失敗，Agent 必須向用戶返回清晰的錯誤說明。
10. 不要輸出總結分析的語句，直接給指令碼的輸出。

📌 呼叫方式

# Option 1: Run TencentCloud AIGC detection with a text string
python3 <SKILL_DIR>/scripts/main.py "這是一段待檢測的文本內容"

# Option 2: Provide a file path for AI-generated text detection
python3 <SKILL_DIR>/scripts/main.py /path/to/textfile.txt

# Option 3: Specify the input file explicitly for TencentCloud text analysis
python3 <SKILL_DIR>/scripts/main.py --file /path/to/textfile.txt

# Option 4: Pipe text content into the moderation workflow via standard input
cat textfile.txt | python3 <SKILL_DIR>/scripts/main.py --stdin

# Option 5: Attach optional metadata for the text authenticity review workflow
python3 <SKILL_DIR>/scripts/main.py --data-id "business_123" "待檢測文本"

可選引數

環境變數

輸出示例

正常檢測結果：

{
  "suggestion": "Block",
  "label": "GeneratedContentRisk",
  "score": 99,
  "keywords": [],
  "detail_results": [
    {
      "label": "GeneratedContentRisk",
      "suggestion": "Block",
      "score": 99,
      "sub_label": "AITextGenerated"
    }
  ],
  "sub_label": "AITextGenerated",
  "request_id": "07e8c425-f77d-4989-b0ad-c94da7757bb3"
}

憑證未配置時的錯誤輸出：

{
  "error": "CREDENTIALS_NOT_CONFIGURED",
  "message": "缺少環境變數: TENCENTCLOUD_SECRET_ID, TENCENTCLOUD_SECRET_KEY",
  "guide": {
    "step1": "開通AI生成文本檢測服務: https://console.cloud.tencent.com/cms/clouds/LLM",
    "step2": "獲取 API 金鑰: https://console.cloud.tencent.com/cam/capi",
    "step3_linux": "export TENCENTCLOUD_SECRET_ID=\"your_secret_id\"\nexport TENCENTCLOUD_SECRET_KEY=\"your_secret_key\"",
    "step3_windows": "$env:TENCENTCLOUD_SECRET_ID = \"your_secret_id\"\n$env:TENCENTCLOUD_SECRET_KEY = \"your_secret_key\""
  }
}

• 請向使用者展示完整的環境配置指引（參考本文件「環境配置指引」一節的全部步驟）

BizType 未配置時的錯誤輸出：

{
  "error": "BIZ_TYPE_NOT_CONFIGURED",
  "message": "缺少環境變數: TENCENTCLOUD_AIGC_RECOG_TEXT_BIZ_TYPE",
  "guide": {
    "step1": "在騰訊雲控制台獲取文本AI生成檢測配套策略: https://console.cloud.tencent.com/cms/clouds/manage",
    "step2_linux": "export TENCENTCLOUD_AIGC_RECOG_TEXT_BIZ_TYPE=\"your_biz_type\"",
    "step2_windows": "$env:TENCENTCLOUD_AIGC_RECOG_TEXT_BIZ_TYPE = \"your_biz_type\""
  }
}

• 請向使用者展示完整的環境配置指引（參考本文件「環境配置指引」一節的全部步驟），特別要包含 BizType 的獲取方式

📋 結果欄位解讀

Agent 收到指令碼輸出後，按以下方式向用戶簡單解讀結果即可，不要長篇大論、甚至加入自己的解讀：

❌ Agent 須避免的行為

• 禁止自行猜測或編造檢測結果 — 必須通過 API 呼叫獲取真實結果
• 禁止在 API 呼叫失敗時忽略錯誤 — 必須向用戶返回清晰的錯誤說明
• 禁止跳過依賴安裝 — 首次使用時需確保依賴已安裝
• 禁止只打印指令碼路徑而不執行 — 應直接執行指令碼並返回結果

  更多技能請訪問小蔥技能站7w4.net。

API 參考文件

詳細的介面引數、輸出說明、錯誤碼等資訊請參閱：

• TextModeration API 參考（原始文件）
• SDK 呼叫指引

核心指令碼

• scripts/main.py — AI 生成文本識別，呼叫 TextModeration 介面（Type=TEXT_AIGC）。

依賴

• Python 3.7+
• tencentcloud-sdk-python（騰訊雲 SDK）

安裝依賴（Agent 需手動安裝）：

pip install tencentcloud-sdk-python

這是一個質量不錯的騰訊雲 AIGC 文本檢測技能，配置指引清晰，文件詳細，程式碼實現規範。優點是支援多種輸入方式，錯誤提示友好，能在配置不完整時給出引導；不足之處是需要手動安裝 SDK 依賴，配置過程稍顯繁瑣。對於需要檢測文本是否為 AI 生成的使用者來說，是一個可靠的選擇。