---
title: Human Plugin 작동 방식
description: Human Plugin을 사용하는 방법입니다. 배포하고, 백엔드에서 프로세스를 생성한 뒤, Human Token과 해당 사용자의 인텔리전스를 읽어 옵니다.
canonical: https://developer.unico.io/ko/human-plugin/get-started/overview
locale: ko
generated_by: markdown-export
---

# Human Plugin 작동 방식

한 번 배포한 뒤, 백엔드에서 호출하면 됩니다.

```mermaid
flowchart LR
  A[Your back-end] -->|POST /v1/processes| B[Human Plugin, in your infrastructure]
  B -->|Human Token + intelligence| A
```

1. 액세스 키와 PostgreSQL 데이터베이스를 사용해 **인프라에 Human Plugin을 배포**합니다. 이 시점부터 Unico 네트워크에 연결됩니다. [인프라에서 Human Plugin 실행하기](/ko/human-plugin/self-hosting/overview)를 참고하세요.
2. [플로우](/ko/human-plugin/api-reference/create-process#flows) 중 하나, `clientId`, 고유한 `correlationId`, 그리고 `credential`에 사용자의 문서를 담아 백엔드에서 **프로세스를 생성**합니다.
3. **결과를 읽습니다**. Human Token은 사용자가 누구인지 알려 주고, [인텔리전스](/ko/human-plugin/get-started/intelligence)는 해당 사용자가 귀사와 어떤 활동을 했는지 알려 줍니다.

## 모든 응답에 포함되는 항목

| 필드 | 의미 |
| --- | --- |
| `id` | 프로세스 ID입니다. `GET /v1/processes/{id}`에 사용합니다 |
| `state` | `PROCESS_STATE_CREATED`, `PROCESS_STATE_FINISHED` 또는 `PROCESS_STATE_FAILED` |
| `data.humanToken` | 사용자가 누구인지 나타냅니다. 재검증에서는 `data.humanTokenMatch`입니다 |
| `data.ndocs` | 사용자의 [인텔리전스](/ko/human-plugin/get-started/intelligence) |

> **팁: 문서는 `credential`로 전송하세요**
>
> 사용자의 문서는 `credential`에만 담아 보냅니다. Human Plugin은 이 값을 귀사의 인프라에 보관하고 인텔리전스에 집계합니다.

## 알아 두면 좋은 점

- Human Plugin은 호출자를 **인증하지 않습니다**. 백엔드에서만 접근할 수 있도록 유지하세요. [네트워킹 및 보안](/ko/human-plugin/self-hosting/networking-and-security)을 참고하세요.
- 프로세스를 나열, 검색 또는 삭제하는 엔드포인트와 웹훅은 없습니다. 대기 중인 프로세스는 조회할 때 업데이트됩니다.

## 다음 단계

1. [인텔리전스](/ko/human-plugin/get-started/intelligence)
2. [사전 요구 사항 및 액세스](/ko/human-plugin/get-started/prerequisites)
3. [퀵스타트](/ko/human-plugin/get-started/quickstart)