78 lines
3.5 KiB
Markdown
78 lines
3.5 KiB
Markdown
# Human‑in‑the‑Loop (HIL) через middleware на FastMCP
|
||
|
||
## Описание проекта
|
||
Проект демонстрирует принцип **Human‑in‑the‑Loop** (человек в потоке выполнения) при помощи простого HTTP‑сервера, реализованного на **FastMCP**.
|
||
Сервер имеет один эндпоинт `/process`. Перед выполнением запроса к этому эндпоинту пользователь должен подтвердить действие через консольный ввод (`yes`/`no`). Это позволяет показать, как можно вставлять ручное вмешательство в автоматический процесс без изменения бизнес‑логики.
|
||
|
||
## Предварительные требования
|
||
- Python 3.10+
|
||
- `pip` (или `pipx`) для установки зависимостей
|
||
|
||
> **Важно**: В данном примере не требуется внешних сервисов, таких как Ollama или Qdrant. Всё работает локально.
|
||
|
||
## Установка
|
||
```bash
|
||
# Клонируйте репозиторий
|
||
git clone https://github.com/your-username/hil-fastmcp.git
|
||
cd hil-fastmcp
|
||
|
||
# Создайте виртуальное окружение (необязательно, но рекомендуется)
|
||
python -m venv .venv
|
||
source .venv/bin/activate # Windows: .\.venv\Scripts\activate
|
||
|
||
# Установите зависимости
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
## Запуск сервера
|
||
```bash
|
||
# Запускаем сервер из файла solution.py
|
||
python solution.py
|
||
```
|
||
После запуска вы увидите сообщение:
|
||
```
|
||
FastMCP server is running on http://127.0.0.1:8000
|
||
```
|
||
|
||
## Пример использования
|
||
|
||
### 1. Отправка запроса к `/process`
|
||
```bash
|
||
curl -X POST http://127.0.0.1:8000/process \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"task":"example"}'
|
||
```
|
||
|
||
После отправки запроса сервер выведет в консоль:
|
||
```
|
||
Do you want to proceed with the request? (yes/no):
|
||
```
|
||
|
||
### 2. Подтверждение действия
|
||
- Введите `yes` и нажмите **Enter** → запрос выполнится, и клиент получит ответ:
|
||
```json
|
||
{"message":"Task processed successfully","task":"example"}
|
||
```
|
||
- Введите `no` → сервер вернёт ошибку 403:
|
||
```json
|
||
{"detail":"Action was not confirmed by the user."}
|
||
```
|
||
|
||
## Структура проекта
|
||
```
|
||
├── solution.py # Основной код сервера с HIL‑middleware
|
||
└── requirements.txt # Список зависимостей (FastMCP)
|
||
```
|
||
|
||
## Как это работает
|
||
1. **Middleware** intercepts every request to `/process`.
|
||
2. Он выводит запрос в консоль и ждёт ввода пользователя.
|
||
3. Если пользователь вводит `yes`, middleware пропускает запрос дальше к обработчику.
|
||
4. В противном случае возвращается HTTP‑ошибка 403.
|
||
|
||
Таким образом, человек имеет контроль над каждым выполнением запроса без необходимости менять логику самого эндпоинта.
|
||
|
||
## Лицензия
|
||
MIT © 2026
|
||
|
||
--- |