AI URL 테스트 에이전트 사용 가이드

AI 에이전트가 자동으로 웹 URL을 탐색·분석·테스트하는 기능의 사용법을 안내합니다.

🚀 AI URL 테스트 기능 바로가기

개요

URL Test Agent는 지정한 URL을 AI 에이전트가 자동으로 접속하여 페이지 구조, 링크 상태, 에러 등을 분석하고 Markdown 형식의 보고서를 생성하는 관리 도구입니다.

빠른 시작

1. 관리 메뉴에서 AI URL 테스트 페이지로 이동합니다.
2. URL 입력 폼에 테스트할 웹 주소를 입력합니다.
3. Submit 버튼을 클릭하면 AI 에이전트가 자동으로 분석을 시작합니다.
4. Test History 목록에서 진행 상태 및 분석 결과를 확인합니다.

테스트 상태

상태	의미
PENDING	대기 중 — AI 에이전트 처리 대기
RUNNING	분석 중 — AI 에이전트가 URL 탐색 중
COMPLETED	완료 — 분석 보고서 확인 가능
FAILED	실패 — URL 접근 불가 또는 에러 발생

상세 기능

결과 보고서 확인

목록에서 항목을 클릭하면 AI가 생성한 분석 보고서를 확인할 수 있습니다. 보고서에는 페이지 구조, 링크 상태, 발견된 문제 등이 포함됩니다.

재실행 (Retry)

완료 또는 실패된 항목을 다시 분석하려면 상세 화면에서 Retry 버튼을 클릭합니다.

삭제 (Delete)

불필요한 테스트 기록은 Delete 버튼으로 삭제할 수 있습니다.

문제 해결

증상	원인	해결 방법
PENDING 상태가 오래 지속됨	AI 에이전트 처리 대기 중	잠시 후 새로 고침
FAILED 상태	URL 접근 불가 또는 인증 필요	URL이 공개 접근 가능한지 확인
목록이 비어있음	프로젝트 미선택	상단 메뉴에서 프로젝트(CSN) 선택 확인

API 참조

AK 인증 API (웹 UI용)

항목	값
엔드포인트	https://giipfaw.azurewebsites.net/api/giipUrlTest
인증	Authorization: Bearer {AK} 또는 x-api-key: {AK}
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 (Agent용)

항목	값
인증	@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.ko.md