> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 프로파일과 아이템

> 워크플로우 상세에서 프로파일을 만들고, Data Objects 탭에서 폴더·아이템을 관리한 뒤 분석을 실행하는 화면.

**위치:** 사이드바 **워크플로우 목록** → 워크플로우 선택 → 프로파일 표 → **상세보기**

프로파일은 검증 대상 하나(예: 거래처 한 곳)를 담는 컨테이너입니다. 프로파일 안에 문서(아이템)를 넣고 **프로파일 분석**을 누르면 워크플로우의 플레이북이 실행됩니다.

## 프로파일 만들기

워크플로우 상세 화면 오른쪽 위의 **+ 프로파일 생성**을 누릅니다.

<Frame caption="프로파일 생성 — 이름과 설명, 필요하면 메타데이터를 입력합니다.">
  <img src="https://mintcdn.com/argosidentity/uzgj8WfVduVpDN5-/images/omni/ko/profile-create-modal.png?fit=max&auto=format&n=uzgj8WfVduVpDN5-&q=85&s=278cf52a0507d9ae56b663e175072a96" alt="프로파일 생성 다이얼로그" width="3756" height="1972" data-path="images/omni/ko/profile-create-modal.png" />
</Frame>

| 입력      | 필수 | 설명                                                                      |
| ------- | -- | ----------------------------------------------------------------------- |
| 프로파일 이름 | ✓  | 목록과 상세 화면 제목에 표시                                                        |
| 설명      |    | 자유 텍스트                                                                  |
| 메타데이터   |    | 키·값 쌍. 자체 시스템의 식별자(예: `vendor_id`)를 넣어 두면 API 응답의 `metadata`로 그대로 돌아옵니다 |

생성된 프로파일은 워크플로우 상세의 표에 나타납니다.

| 열                              | 설명                                      |
| ------------------------------ | --------------------------------------- |
| 프로파일 ID                        | `pf_` 접두사. API 호출에 사용                   |
| 프로파일 이름 · 아이템 수 · 마지막 분석 · 생성일 | 마지막 분석은 실행 이력이 없으면 `-`                  |
| 작업                             | **상세보기** · **수정**(이름·설명·메타데이터) · **삭제** |

프로파일 삭제는 확인을 위해 관리자 이메일을 입력해야 하며, 폴더·아이템·분석 결과가 함께 삭제됩니다.

## Data Objects 탭

프로파일 상세는 **Analysis Results**와 **Data Objects** 두 탭으로 구성됩니다. 문서 관리는 Data Objects에서 합니다.

| 요소           | 설명                                                              |
| ------------ | --------------------------------------------------------------- |
| 폴더 수 · 아이템 수 | 프로파일 전체 집계                                                      |
| 폴더 추가        | 이름만 입력해 폴더를 만듭니다. 폴더 없이 추가한 아이템은 **폴더없음** 그룹에 들어갑니다(API의 기본 폴더) |
| 아이템 추가       | 아래 참조                                                           |
| 프로파일 분석      | 모든 아이템이 `ACTIVE`일 때 실행할 수 있습니다                                  |

폴더 이름 옆 메뉴에서 **폴더 수정**·**폴더 삭제**를 할 수 있습니다. 폴더를 삭제하면 안의 아이템도 삭제되며, 관리자 이메일 확인이 필요합니다.

## 아이템 추가

<Frame caption="아이템 추가 — 텍스트 콘텐츠를 직접 입력하거나 파일을 올립니다. 둘 중 하나는 필수입니다.">
  <img src="https://mintcdn.com/argosidentity/uzgj8WfVduVpDN5-/images/omni/ko/item-add-modal.png?fit=max&auto=format&n=uzgj8WfVduVpDN5-&q=85&s=35597b160f6a359053472b1265b59038" alt="아이템 추가 다이얼로그" width="3756" height="1972" data-path="images/omni/ko/item-add-modal.png" />
</Frame>

| 입력           | 설명                                                                                                                           |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| 폴더           | 폴더가 있을 때 선택                                                                                                                  |
| 아이템 이름       | 필수                                                                                                                           |
| Text Content | 텍스트를 직접 붙여 넣습니다. 계약서 본문, OCR을 이미 거친 텍스트 등                                                                                    |
| File Content | 드래그 앤 드롭 또는 클릭. 지원 형식: PDF · DOCX · XLSX · PPTX · 이미지(JPG, PNG, GIF, BMP, WEBP, TIFF) · TXT · MD · HTML · EML · CSV, 최대 10MB |
| 메타데이터        | 키·값 쌍(선택)                                                                                                                    |

추가 직후 아이템은 `PENDING`이며 텍스트 추출이 끝나면 `ACTIVE`가 됩니다. 텍스트 아이템은 수 초, 이미지·PDF는 OCR 시간만큼 걸립니다. 목록이 자동으로 갱신되지 않으면 새로고침하세요.

| 상태        | 의미                |
| --------- | ----------------- |
| `PENDING` | 텍스트 추출 중          |
| `ACTIVE`  | 분석에 사용 가능         |
| `FAILED`  | 추출 실패. 삭제 후 다시 추가 |

아이템 카드의 **⋯** 메뉴:

| 메뉴     | 동작                                                               |
| ------ | ---------------------------------------------------------------- |
| 상세 보기  | 기본 정보(이름·ID·상태·유형), 파일 정보(콘텐츠 타입·폴더), 메타데이터, 추출된 콘텐츠(RAG)를 보여줍니다 |
| 아이템 수정 | 이름과 메타데이터만 수정. 콘텐츠는 바꿀 수 없으므로 삭제 후 다시 추가                         |
| 아이템 삭제 | 관리자 이메일 확인 후 삭제                                                  |

<Tip>
  이미지·PDF를 올렸다면 **상세 보기**의 콘텐츠 영역에서 OCR 결과를 확인하세요. 여기 보이는 텍스트가 에이전트가 읽는 전부입니다. 핵심 값이 빠져 있으면 더 선명한 사본으로 교체하는 편이 정책을 고치는 것보다 효과적입니다.
</Tip>

## 프로파일 분석

**프로파일 분석**을 누르면 분석이 큐에 등록되고 화면이 **Analysis Results** 탭으로 전환됩니다. 진행 중에는 상태 배지가 `처리중`으로 표시되고 점수 카드가 비어 있습니다.

| 상황                    | 화면 메시지                                      |
| --------------------- | ------------------------------------------- |
| `ACTIVE`가 아닌 아이템이 있음  | "모든 아이템의 상태가 ACTIVE여야 프로파일 분석을 진행할 수 있습니다." |
| 같은 프로파일에 진행 중인 분석이 있음 | "이미 진행 중인 분석이 있습니다"                         |
| 체험판 일일 한도(10회) 초과     | "분석 요청 한도를 초과했습니다"                          |

결과 화면은 [분석 결과](/ko/omni/dashboard/analysis-results)에서 설명합니다.

## 제한

| 항목              | 값     |
| --------------- | ----- |
| 폴더당 아이템         | 제한 없음 |
| 프로파일당 누적 업로드 용량 | 100MB |
| 파일 하나 크기        | 10MB  |
| 프로파일당 폴더        | 제한 없음 |

## 관련 API

* [`POST /workflows/:workflowId/profiles`](/ko/omni/api-reference/post-profile) · [`POST /folders/:folderId/items/upload`](/ko/omni/api-reference/post-item) · [`POST /analyses/:profileId/analyze`](/ko/omni/api-reference/post-analysis)
* 아이템 상태 폴링: [`GET /profiles/:profileId/items/status`](/ko/omni/api-reference/get-profiles#아이템-상태-조회)