AI URL Test Agent User Guide

This guide explains how to use the AI-powered URL testing tool that automatically explores, analyzes, and tests web URLs.

🚀 Go to AI URL Test Feature

Overview

The URL Test Agent automatically accesses specified URLs using an AI agent to analyze page structure, link status, and errors, generating a Markdown report.

Quick Start

Navigate to the AI URL Test page from the admin menu.
Enter the web address you want to test in the URL input form.
Click Submit — the AI agent will begin analysis automatically.
Check the Test History list for progress and results.

Test Status

Status	Meaning
PENDING	Waiting — queued for AI agent processing
RUNNING	Analyzing — AI agent is crawling the URL
COMPLETED	Done — analysis report is available
FAILED	Error — URL unreachable or error occurred

Features

Viewing the Report

Click any item in the list to view the AI-generated analysis report, including page structure, link status, and detected issues.

Retry

To re-analyze a completed or failed item, click Retry in the detail view.

Delete

Remove unnecessary test records using the Delete button.

Troubleshooting

Symptom	Cause	Solution
PENDING for a long time	Agent processing queue	Refresh after a moment
FAILED status	URL unreachable or requires auth	Verify the URL is publicly accessible
Empty list	No project selected	Check that a project (CSN) is selected

API Reference

AK Auth API (Web UI)

Item Value

Item	Value
Endpoint	`https://giipfaw.azurewebsites.net/api/giipUrlTest`
Auth	`Authorization: Bearer {AK}` or `x-api-key: {AK}`
AK Source	Web session token ( `sessionStorage['token']` )

Endpoint

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

Auth

Authorization: Bearer {AK}

x-api-key: {AK}

AK Source

Web session token (

sessionStorage['token']

)

GET — List

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

Response:

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

POST — Create

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

{ "csn": 47, "url": "https://example.com", "depth": "SHALLOW", "context": "analysis hint (optional)" }

```
depth
```
:
```
"SHALLOW"
```
(default) or
```
"DEEP"
```

Response:

{ "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 }

Response:

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

DELETE — Delete

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

Response:

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

SK Auth API (Agent)

Item	Value
Auth	`@sk` parameter (Secret Key)
SK Source	`$env:GIIP_SECRET_KEY` (system environment variable)
Purpose	urlTester Timer Function auto-processes PENDING tasks in background

pApiURLTestGetbySk — Get PENDING list

EXEC pApiURLTestGetbySk @sk = '{secret_key}'

Returns: up to 100

status = 'PENDING'

records (ASC by registration order)

pApiURLTestPutbySk — Update status/result

EXEC pApiURLTestPutbySk
    @sk             = '{secret_key}',
    @csn            = 47,
    @task_id        = 'URLTEST_...',
    @status         = 'COMPLETE',        -- RUNNING / COMPLETE / ERROR
    @result_summary = 'summary text',    -- optional
    @result_detail  = '## Markdown'      -- optional

Status Values

Status	Meaning	End time recorded
`PENDING`	Waiting	❌
`RUNNING`	Processing	❌
`COMPLETE`	Done	✅
`ERROR`	Error	✅

⚠️
COMPLETED
/
FAILED
are not valid. Use
COMPLETE
/
ERROR
.

Version: 1.0 Last Updated: 2026-06-15 Source:

giipv3/public/help/url-test.en.md