---
title: Human Plugin 的工作原理
description: 如何使用 Human Plugin：部署它，从您的后端创建流程，并读取 Human Token 和该用户的智能洞察。
canonical: https://developer.unico.io/zh-CN/human-plugin/get-started/overview
locale: zh-CN
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. **在您的基础设施中部署 Human Plugin**，并配置您的访问密钥和一个 PostgreSQL 数据库。此后，您便接入了 Unico 的网络。请参阅[在您的基础设施中运行 Human Plugin](/zh-CN/human-plugin/self-hosting/overview)。
2. **从您的后端创建流程**：使用其中一种[流程](/zh-CN/human-plugin/api-reference/create-process#flows)，并提供您的 `clientId`、唯一的 `correlationId`，以及放在 `credential` 中的用户证件。
3. **读取结果**：Human Token 告诉您这个人是谁，[智能洞察](/zh-CN/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` | 该用户的[智能洞察](/zh-CN/human-plugin/get-started/intelligence) |

> **提示: 请在 `credential` 中发送证件**
>
> 用户的证件只应放在 `credential` 中。Human Plugin 会将其保存在您的基础设施内，并将其计入智能洞察。

## 须知

- Human Plugin **不会**对调用方进行身份验证。请确保只有您的后端可以访问它：请参阅[网络与安全](/zh-CN/human-plugin/self-hosting/networking-and-security)。
- 没有用于列出、搜索或删除流程的端点，也没有 webhook。待处理的流程会在您读取它时更新。

## 下一步

1. [智能洞察](/zh-CN/human-plugin/get-started/intelligence)
2. [前提条件与访问权限](/zh-CN/human-plugin/get-started/prerequisites)
3. [快速入门](/zh-CN/human-plugin/get-started/quickstart)