빠른 시작 - ARGOS Identity

거래처가 제출한 서류 3종을 검증하는 워크플로우를 만들고, API로 프로파일을 만들어 분석 결과까지 받아봅니다.

How to Use

Review Ops Agent에게 업무 방식을 알려주는 일은 대시보드에서, 검토 대상별 실행은 API로 합니다.

Omni 프로세스 흐름도 — 설정(정책·엔진·출력 스키마) → 데이터 수집(OCR·정규화) → 분석·검증 → 리포트·JSON·감사 로그 생성 → 사용자 서버 전달.

구성 요소

자연어 정책

업무 방식과 판단 기준을 일반 문장으로 씁니다. 정책 조항 하나가 실행 단계 하나가 됩니다.

엔진 자동 배정

어떤 검증에 어떤 엔진이 필요한지 고르지 않아도 됩니다. 정책 내용을 보고 자동으로 붙고 실행 순서도 자동으로 정해집니다.

출력 스키마

받을 JSON 구조를 직접 정의합니다. 시스템이 기대하는 형태 그대로 결과가 내려오므로 후처리 변환이 필요 없습니다.

판정 근거

값만 주지 않고 왜 그 값이 되었는지 함께 줍니다. 단계별 실행 기록과 외부 조회 내역이 감사 로그로 남습니다.

전체 흐름

워크플로우 설정 (대시보드)

정책을 쓰고 받을 출력 스키마를 정의합니다. 저장하면 플레이북이 생성됩니다.

프로파일 생성 (API)

검증 대상 하나마다 프로파일을 만듭니다. 거래처 한 곳, 신청자 한 명이 프로파일 하나입니다.

서류 등록 (API)

프로파일에 문서를 올립니다. 이미지·PDF는 OCR을, 오피스 문서는 텍스트 추출을 거칩니다.

분석 실행 (API)

플레이북이 순서대로 실행되고, 출력 스키마 구조에 맞춘 결과와 판정이 돌아옵니다.

워크플로우 생성·수정은 대시보드에서만 합니다. 나머지는 전부 API로 자동화할 수 있습니다. 아래 1절에서 1단계를, 2절에서 2~4단계를 직접 실행합니다.

1. 대시보드에서 프로젝트와 워크플로우 만들기

프로젝트 생성

대시보드에서 새 프로젝트 생성을 누르고 이름과 설명을 입력합니다. 이 문서는 Demo라는 프로젝트를 예로 씁니다.생성 직후 API 키가 함께 발급됩니다. 프로젝트 설정의 API 키 탭에서 확인하세요 — API 키 관리.

워크플로우 생성

프로젝트 안에서 워크플로우 생성을 누르면 4단계 마법사가 열립니다.

기본 정보 — 이름 거래처 온보딩 서류 검증 정책
정책 정의 — 무엇을 어떤 기준으로 검증할지 자연어로 씁니다
AI 모델 선택 — 지정하지 않으면 기본 모델을 씁니다
출력 스키마 — 분석 결과로 받을 JSON 구조를 정의합니다

저장하면 정책 텍스트에서 플레이북(실행 계획)이 생성됩니다. 2~3분 걸립니다. 자세한 절차는 워크플로우 만들기에 있습니다.

이후 단계에서 쓸 값 두 개를 확보했습니다 — API 키와 워크플로우 ID(wf_ 접두사). 워크플로우 ID는 프로젝트를 조회해도 확인할 수 있습니다.

curl "https://client-omni-api.argosidentity.com/v1/projects/proj_75hgxoxamzn9" \
  -H "x-api-key: your-api-key-here"

2. API로 분석 실행하기

프로파일 생성

프로파일은 검증 대상 하나를 담는 단위입니다. 거래처 한 곳, 신청자 한 명이 프로파일 하나에 해당합니다.

curl -X POST "https://client-omni-api.argosidentity.com/v1/workflows/wf_knsb7si44x27/profiles" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "예시 프로파일",
    "description": "문서 검증 예시용 프로파일",
    "metadata": { "vendor_id": "VND-2026-0142" }
  }'

응답의 id가 프로파일 ID이고, folders[0].id가 자동 생성된 기본 폴더 ID입니다. 다음 단계에서 둘 다 씁니다.

{
  "id": "pf_0twd91ioowfr",
  "folders": [{ "id": "fd_dvh8axwowi4v", "name": "default", "isDefault": true }]
}

서류 등록

기본 폴더에 서류를 올립니다. 파일을 올리거나 텍스트를 직접 보낼 수 있습니다.

curl -X POST "https://client-omni-api.argosidentity.com/v1/folders/fd_dvh8axwowi4v/items/upload" \
  -H "x-api-key: your-api-key-here" \
  -F "file=@/path/to/business-registration.pdf" \
  -F "name=사업자등록증" \
  -F "metadata={\"doc_type\":\"business_registration\"}"

응답의 id(item_ 접두사)를 기록해 두세요. 분석 요청에 넣어야 합니다. 서류 3종을 같은 방식으로 등록합니다.

파일 하나는 10MB까지, 프로파일 하나에 올릴 수 있는 누적 용량은 100MB까지입니다. 폴더당 개수 제한은 없습니다. 지원 형식은 아이템 등록에 있고, 목록에 없는 형식은 업로드 시점에 거부됩니다.

처리 완료 대기

등록된 아이템은 텍스트 추출을 거쳐 PENDING에서 ACTIVE로 바뀝니다. 모두 ACTIVE가 되어야 분석을 실행할 수 있습니다.

curl "https://client-omni-api.argosidentity.com/v1/profiles/pf_0twd91ioowfr/items/status" \
  -H "x-api-key: your-api-key-here"

{
  "profileId": "pf_0twd91ioowfr",
  "isRagReady": true,
  "summary": { "total": 3, "pending": 0, "active": 3, "failed": 0 },
  "items": [
    {
      "id": "item_ieoravdq3jp3",
      "name": "사업자등록증",
      "type": "file",
      "status": "ACTIVE",
      "processedAt": "2026-09-09T09:05:38.902Z"
    }
  ]
}

isRagReady가 true가 될 때까지 1초 간격으로 폴링하고 60초에서 멈추세요. 그때까지 ACTIVE가 되지 않은 아이템은 삭제하고 다시 올리는 편이 빠릅니다.

분석 실행

분석에 넣을 아이템 ID를 targetItems로 전달합니다. 워크플로우의 정책·엔진·출력 스키마가 자동으로 적용됩니다.

curl -X POST "https://client-omni-api.argosidentity.com/v1/analyses/pf_0twd91ioowfr/analyze" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "targetItems": [
      { "itemId": "item_ieoravdq3jp3" },
      { "itemId": "item_we03t42pxgbc" },
      { "itemId": "item_veliji1hm3ih" }
    ]
  }'

분석은 비동기입니다. 응답은 분석 ID만 즉시 돌려줍니다.

{ "id": "analysis_lghgsxkorvoc" }

결과 조회

분석 ID로 상태를 폴링하다가 status가 completed가 되면 결과를 읽습니다.

curl "https://client-omni-api.argosidentity.com/v1/analyses/analysis_lghgsxkorvoc" \
  -H "x-api-key: your-api-key-here"

{
  "status": "completed",
  "verificationStatus": "verified",
  "confidence": { "score": 93, "level": "HIGH" },
  "extractedData": {
    "company": {
      "name": {
        "value": "주식회사 에이씨엠이 트레이딩",
        "reasoning": "사업자등록증의 법인명 항목에서 확인했습니다.",
        "sourceStep": 1
      }
    }
  }
}

읽을 것은 세 가지입니다.

필드	무엇
`verificationStatus`	분석 전체 판정 — `verified` · `pending_review` · `rejected`
`confidence.score`	Analysis Score. 산출물이 얼마나 채워졌는지(0–100)
`extractedData`	출력 스키마대로 추출된 값. 말단 필드는 `value` · `reasoning` · `sourceStep` 봉투로 감싸짐

사람이 읽을 PDF가 필요하면 GET /analyses/:analysisId/report로 받으세요.

다음 단계

분석 결과 읽기

봉투 구조, 비어 있는 필드의 사유, 판정 값을 읽는 순서.

핵심 개념

프로젝트부터 분석까지의 데이터 계층과 플레이북 개념.

워크플로우 만들기

정책 작성부터 출력 스키마까지 대시보드 전체 절차.

API 참조

엔드포인트 23개의 전체 정의.

​How to Use

​구성 요소

자연어 정책

엔진 자동 배정

출력 스키마

판정 근거

​전체 흐름

​1. 대시보드에서 프로젝트와 워크플로우 만들기

​2. API로 분석 실행하기

​다음 단계

분석 결과 읽기

핵심 개념

워크플로우 만들기

API 참조

How to Use

구성 요소

전체 흐름

1. 대시보드에서 프로젝트와 워크플로우 만들기

2. API로 분석 실행하기

다음 단계