AI URL測試代理使用者指南

本指南介紹AI代理自動探索、分析和測試Web URL功能的使用方法。

🚀 前往 AI URL 測試功能

概述

URL Test Agent是一款管理工具，AI代理自動存取指定URL，分析頁面結構、連結狀態和錯誤，並產生Markdown格式的分析報告。

快速開始

從管理選單進入 AI URL測試 頁面。
在URL輸入框中輸入要測試的網址。
點擊 Submit 按鈕，AI代理將自動開始分析。
在 Test History 清單中查看進度和分析結果。

測試狀態

狀態	說明
PENDING	等待中 — 等待AI代理處理
RUNNING	分析中 — AI代理正在探索URL
COMPLETED	完成 — 可查看分析報告
FAILED	失敗 — URL無法存取或發生錯誤

主要功能

查看報告

點擊清單中的任意項目，可查看AI產生的分析報告，包含頁面結構、連結狀態和偵測到的問題。

重新執行 (Retry)

若要重新分析已完成或失敗的項目，在詳情頁面點擊 Retry 按鈕。

刪除 (Delete)

使用 Delete 按鈕刪除不需要的測試記錄。

疑難排解

症狀	原因	解決方法
PENDING長時間不變	代理處理佇列	稍後重新整理頁面
FAILED狀態	URL無法存取或需要認證	確認URL是否可公開存取
清單為空	未選擇專案	確認頂部選單中已選擇專案(CSN)

API 參考

AK 認證 API（Web UI）

項目值

項目	值
端點	`https://giipfaw.azurewebsites.net/api/giipUrlTest`
認證	`Authorization: Bearer {AK}` 或 `x-api-key: {AK}`
AK來源	Web工作階段權杖（ `sessionStorage['token']` ）

端點

https://giipfaw.azurewebsites.net/api/giipUrlTest

認證

Authorization: Bearer {AK}

或

x-api-key: {AK}

AK來源

Web工作階段權杖（

sessionStorage['token']

）

GET — 清單查詢

GET /api/giipUrlTest?csn={csn}
Authorization: Bearer {AK}

回應:

{ "tests": [{ "taskId": "URLTEST_...", "csn": 47, "url": "https://...", "status": "PENDING", "depth": "SHALLOW", "context": null, "resultSummary": null, "resultDetail": null, "regDate": "...", "endDate": null }] }

POST — 新增登錄

POST /api/giipUrlTest
Authorization: Bearer {AK}
Content-Type: application/json

{ "csn": 47, "url": "https://example.com", "depth": "SHALLOW", "context": "分析提示（可選）" }

```
depth
```
:
```
"SHALLOW"
```
（預設值）或
```
"DEEP"
```

回應:

{ "success": true, "taskId": "URLTEST_...", "message": "Created" }

PATCH — 重新執行（Retry）

PATCH /api/giipUrlTest
Authorization: Bearer {AK}
Content-Type: application/json

{ "task_id": "URLTEST_...", "status": "PENDING", "csn": 47 }

回應:

{ "success": true, "message": "Updated successfully" }

DELETE — 刪除

DELETE /api/giipUrlTest?task_id=URLTEST_...
Authorization: Bearer {AK}

回應:

{ "success": true, "message": "Deleted" }

SK 認證 API（代理）

項目	值
認證	`@sk` 參數（Secret Key）
SK來源	`$env:GIIP_SECRET_KEY` （系統環境變數）
用途	urlTester Timer Function在背景自動處理PENDING任務

pApiURLTestGetbySk — 查詢PENDING清單

EXEC pApiURLTestGetbySk @sk = '{secret_key}'

status = 'PENDING'

的項目，最多100筆（依登錄順序ASC）

pApiURLTestPutbySk — 更新狀態/結果

EXEC pApiURLTestPutbySk
    @sk             = '{secret_key}',
    @csn            = 47,
    @task_id        = 'URLTEST_...',
    @status         = 'COMPLETE',        -- RUNNING / COMPLETE / ERROR
    @result_summary = '摘要文字',        -- 可選
    @result_detail  = '## Markdown'      -- 可選

狀態值

狀態	意義	記錄完成時間
`PENDING`	等待中	❌
`RUNNING`	處理中	❌
`COMPLETE`	完成	✅
`ERROR`	錯誤	✅

⚠️
COMPLETED
/
FAILED
無效。請使用
COMPLETE
/
ERROR
。

版本: 1.0 最後更新: 2026-06-15 來源檔案:

giipv3/public/help/url-test.zh-TW.md

AI URL測試代理 使用者指南

概述