작업 실행
AgentTools API
작업 실행
AgentTools 템플릿에서 수집 작업을 생성하고 시작합니다.
POST
작업 실행
요청 본문, 생성된 cURL 예제 및 응답 스키마는 API 패널에 표시됩니다. 놓치기 쉬운 실행 규칙은 이 페이지를 참고하세요.
searchTemplates가 반환한 템플릿에서 수집 작업을 생성하고 시작합니다.
1
템플릿 선택
searchTemplates에서 받은 templateName을 전달합니다.2
매개변수 직렬화
parameters를 문자열로 직렬화한 JSON 객체로 전송합니다.3
서버 안내 따르기
고정된 폴링 간격 대신
retryGuidance, suggestedNextCall, workflow, toolHint를 사용합니다.필수 헤더
사용자 범위 실행에는
x-external-user-id가 필요합니다.행 제한
targetMaxRows는 선택 사항이며 0부터 1000000까지 허용합니다.요청 본문 필드
요청 본문 필드
templateName은 필수입니다.taskName은 선택 사항입니다.parameters는 선택 사항이지만, 지정할 경우 직렬화된 JSON 객체여야 합니다.targetMaxRows는 선택 사항입니다.상태 값
상태 값
accepted: 실행 요청이 수락되었습니다.ready: 데이터를 내보낼 준비가 되었을 수 있습니다.awaiting_source_selection: 소스 기반 필드에 유효한 옵션 키가 필요합니다.invalid, start_failed, failed: recoverySuggestion, blockingIssues, missingParamNames, invalidSourceSelections를 확인하세요.중요 응답 필드
중요 응답 필드
taskId는 내보내거나 확인할 작업을 식별합니다.lotNo는 배치 또는 실행을 식별합니다. 반환되면 exportData에 전달하세요.recoverySuggestion, blockingIssues, missingParamNames, invalidSourceSelections는 클라이언트가 잘못된 호출을 수정하는 데 도움이 됩니다.