---
title: Human Plugin の仕組み
description: Human Plugin の使い方 — デプロイし、バックエンドからプロセスを作成して、Human Token と本人のインテリジェンスを取得します。
canonical: https://developer.unico.io/ja/human-plugin/get-started/overview
locale: ja
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 を実行する](/ja/human-plugin/self-hosting/overview) を参照してください。
2. バックエンドから、いずれかの[フロー](/ja/human-plugin/api-reference/create-process#flows)、`clientId`、一意の `correlationId`、そして `credential` に本人のドキュメントを指定して**プロセスを作成**します。
3. **結果を取得します**。Human Token は本人が誰であるかを示し、[インテリジェンス](/ja/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` | 本人の[インテリジェンス](/ja/human-plugin/get-started/intelligence) |

> **ヒント: ドキュメントは `credential` で送信してください**
>
> 本人のドキュメントは `credential` にのみ指定します。Human Plugin はここに指定された値をお客様のインフラストラクチャ内に保持し、インテリジェンスの集計に使用します。

## 知っておくべきこと

- Human Plugin は呼び出し元を認証**しません**。バックエンドからのみ到達できるようにしてください。詳しくは [ネットワークとセキュリティ](/ja/human-plugin/self-hosting/networking-and-security) を参照してください。
- プロセスの一覧取得、検索、削除を行うエンドポイントはなく、Webhook もありません。保留中のプロセスは、読み取ったときに更新されます。

## 次へ

1. [インテリジェンス](/ja/human-plugin/get-started/intelligence)
2. [前提条件とアクセス](/ja/human-plugin/get-started/prerequisites)
3. [クイックスタート](/ja/human-plugin/get-started/quickstart)