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-CN.md

AI URL测试代理 用户指南

概述