AI URLテストエージェント ユーザーガイド

AIエージェントがWebのURLを自動で探索・分析・テストする機能の使い方を説明します。

🚀 AI URLテスト機能を開く

概要

URL Test Agentは、指定したURLにAIエージェントが自動でアクセスし、ページ構造・リンク状態・エラーを分析してMarkdown形式のレポートを生成する管理ツールです。

クイックスタート

1. 管理メニューから AI URLテスト ページに移動します。
2. URLフォームにテストしたいWebアドレスを入力します。
3. Submit ボタンをクリックすると、AIエージェントが自動で分析を開始します。
4. Test History リストで進行状況と分析結果を確認します。

テストステータス

主な機能

レポートの確認

リストのアイテムをクリックすると、AIが生成した分析レポートを確認できます。ページ構造、リンク状態、検出された問題などが含まれます。

再実行 (Retry)

完了または失敗したアイテムを再分析するには、詳細画面で Retry ボタンをクリックします。

削除 (Delete)

不要なテスト記録は Delete ボタンで削除できます。

トラブルシューティング

API リファレンス

AK認証 API（Web UI用）

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

Authorization: Bearer {AK}

x-api-key: {AK}

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

$env:GIIP_SECRET_KEY

pApiURLTestGetbySk — PENDING一覧取得

EXEC pApiURLTestGetbySk @sk = '{secret_key}'

返却:

status = 'PENDING'

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