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

5. 不要輸出總結分析的語句，直接給指令碼的輸出。

📌 呼叫方式

# 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 呼叫失敗時忽略錯誤 — 必須向用戶返回清晰的錯誤說明
• 禁止跳過依賴安裝 — 首次使用時需確保依賴已安裝
• 禁止只打印指令碼路徑而不執行 — 應直接執行指令碼並返回結果

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 生成的使用者來說，是一個可靠的選擇。