145 lines
6.9 KiB
Markdown
145 lines
6.9 KiB
Markdown
# `:standalone` — single-jar HTTP-сервер со всеми транспортами
|
||
|
||
## Что это
|
||
|
||
Главный исполняемый модуль проекта — single-jar HTTP-сервер с:
|
||
|
||
- **A2A** transport на `POST /` (JSON-RPC) + `GET /.well-known/agent-card.json`.
|
||
- **`:proto`** transport на `POST /agentik/*` (HTTP+JSON+SSE) — наш stateful.
|
||
- **Embedded LLM backend**: `GOOGLE` (LiteRT) или `OPENAI`-совместимый
|
||
(vLLM, LiteLLM, OpenAI API).
|
||
- **SQLite persistence** через `:storage-sqlite`.
|
||
- **Memory backend**: `md` (файловый) или `vector` (SQLite+JVector+
|
||
HTTP/SIGLIP-embeddings).
|
||
- **Skills** из `~/.agentik/skills/*.md`.
|
||
- **SOUL** из `~/.agentik/SOUL.md`.
|
||
- **Background подпроцессы**: рефлексия, skill-mining,
|
||
memory-reviewer.
|
||
|
||
Решает: даёт пользователю один JAR (10–250 МБ), который запускается
|
||
через `java -jar agentik-0.1.0-all.jar`, и поднимает сразу все
|
||
транспорты, которые другие системы могут хавать.
|
||
|
||
## Как запустить
|
||
|
||
### Требования
|
||
|
||
- JVM 21+.
|
||
- (Опционально) CUDA-устройство для `:backend=google` (LiteRT).
|
||
- (Опционально) LM через OpenAI-совместимый endpoint (vLLM / Ollama
|
||
/ OpenAI) для `:backend=openai`.
|
||
|
||
### Запуск из готового fatjar
|
||
|
||
```bash
|
||
java --enable-native-access=ALL-UNNAMED \
|
||
-jar agentik-0.1.0-all.jar
|
||
```
|
||
|
||
С дефолтами — встроенный SQLite, OpenAI-compatible backend на
|
||
`http://localhost:8001/v1`, порт 8080.
|
||
|
||
### Запуск через Gradle (dev)
|
||
|
||
```bash
|
||
./gradlew :standalone:run
|
||
```
|
||
|
||
### `pull-model` subcommand (для LiteRT)
|
||
|
||
```bash
|
||
# Сначала скачать модель под LiteRT-Gemma-4-E2B
|
||
AGENTIK_LLM_BACKEND=google \
|
||
AGENTIK_GOOGLE_MODEL_PATH=/root/gemma-4-E2B-it.litertlm \
|
||
java --enable-native-access=ALL-UNNAMED \
|
||
-jar agentik-0.1.0-all.jar pull-model
|
||
```
|
||
|
||
Скачивает `https://static.binom.pw/models/gemma-4-E2B-it.litertlm`
|
||
(2.5 ГБ, с Range-resume). Поддерживает override через
|
||
`AGENTIK_GOOGLE_MODEL_URL` и verify через
|
||
`AGENTIK_GOOGLE_MODEL_SHA256_URL`.
|
||
|
||
## Переменные среды
|
||
|
||
Полный список — общий для всего `:standalone`-процесса:
|
||
|
||
| Env | Default | Что делает |
|
||
|---|---|---|
|
||
| `AGENTIK_PORT` | `8080` | Порт HTTP-сервера |
|
||
| `AGENTIK_DB_PATH` | `./agentik.db` | Путь к SQLite |
|
||
| `AGENTIK_TOKEN` | (пусто) | Bearer-токен для HTTP-фасада `/agentik`. Пусто — авторизация выключена |
|
||
| `AGENTIK_A2A_TOKEN` | (пусто) | Bearer-токен для A2A-фасада `/a2a`. Пусто — авторизация выключена (независим от `AGENTIK_TOKEN`) |
|
||
| `AGENTIK_AGENT_ID` | `agentik` | ID агента (для multi-instance) |
|
||
| `AGENTIK_LLM_BACKEND` | `openai` | `openai` или `google` |
|
||
| `AGENTIK_LLM_MODEL` | (выбирается по backend) | Имя модели |
|
||
| `AGENTIK_LLM_API_URL` | `http://localhost:8001/v1` | Endpoint для OpenAI-compatible |
|
||
| `AGENTIK_LLM_API_KEY` | `no-key-needed` | Auth header |
|
||
| `AGENTIK_LLM_CONTEXT_TOKENS` | `115000` | Сколько токенов остаётся модели |
|
||
| `AGENTIK_GOOGLE_MODEL_PATH` | `/root/gemma-4-E2B-it.litertlm` | Путь к `.litertlm` файлу |
|
||
| `AGENTIK_GOOGLE_MODEL_URL` | `https://static.binom.pw/models/gemma-4-E2B-it.litertlm` | Откуда скачивать |
|
||
| `AGENTIK_GOOGLE_MODEL_SHA256_URL` | — | Если задан — verify по SHA-256 |
|
||
| `AGENTIK_AUTO_DOWNLOAD_MODEL` | `0` | `1` = скачать модель если её нет |
|
||
| `AGENTIK_MEMORY_BACKEND` | `vector` | `md`, `vector` или `off` |
|
||
| `AGENTIK_EMBEDDING_BACKEND` | `http` | `http` или `siglip` (только для `vector`) |
|
||
| `AGENTIK_EMBEDDING_API_URL` | `http://localhost:8001/v1` | Endpoint для эмбеддингов |
|
||
| `AGENTIK_EMBEDDING_MODEL` | `text-embedding-3-small` | Имя embedding-модели |
|
||
| `AGENTIK_SOUL_PATH` | `~/.agentik/SOUL.md` | Путь к SOUL.md |
|
||
| `AGENTIK_SKILLS_DIR` | `~/.agentik/skills/` | Каталог SKILL.md |
|
||
| `AGENTIK_MEMORY_DIR` | `~/.agentik/memory/` | Каталог для md-памяти |
|
||
| `AGENTIK_TOOLSETS_DEFAULT` | `memory,skills,files,web` | Включённые тулы |
|
||
| `AGENTIK_DEBUG` | `0` | `1` = verbose logging |
|
||
|
||
Значения читаются через `AgentikConfig.fromEnv()` в `:standalone/.../Main.kt`.
|
||
|
||
## Эндпоинты
|
||
|
||
| Метод | Путь | Transport | Описание |
|
||
|---|---|---|---|
|
||
| `GET` | `/health` | любой | health-check (`{"ok":true}`) |
|
||
| `POST` | `/` | A2A | JSON-RPC `message/send`, `tasks/get`, `tasks/cancel` |
|
||
| `GET` | `/.well-known/agent-card.json` | A2A | Discovery |
|
||
| `POST` | `/agentik/conversations` | :proto | Создать диалог |
|
||
| `GET` | `/agentik/conversations` | :proto | Список диалогов |
|
||
| `GET` | `/agentik/conversations/:id` | :proto | Snapshot |
|
||
| `GET` | `/agentik/conversations/:id/messages` | :proto | История |
|
||
| `POST` | `/agentik/conversations/:id/send` | :proto | Send (SSE) |
|
||
| `GET` | `/agentik/conversations/:id/events` | :proto | Live-events (SSE) |
|
||
| `POST` | `/agentik/conversations/:id/interrupt` | :proto | Прервать |
|
||
| `POST` | `/agentik/conversations/:id/rename` | :proto | Переименовать |
|
||
| `DELETE` | `/agentik/conversations/:id` | :proto | Удалить |
|
||
|
||
## Тесты
|
||
|
||
```
|
||
./gradlew :standalone:jvmTest # unit-тесты
|
||
./gradlew :standalone:integrationTest # integration (Testcontainers)
|
||
./gradlew :standalone:shadowJar # → build/libs/agentik-0.1.0-all.jar
|
||
```
|
||
|
||
## Известные ограничения
|
||
|
||
1. **vLLM не поддерживает cancel-inference** (`interrupt()` только
|
||
закрывает client SSE-socket; бэкенд всё равно генерирует до конца).
|
||
2. **A2A JSON discriminator — `"kind"`** (text/file/data),
|
||
а не `"type"`. См. `A2aJson` в `:standalone`.
|
||
3. **SSE в не-TTY ssh закрывается на default Ktor timeout**.
|
||
|
||
## Текущий статус
|
||
|
||
Production-ready. Все KMP-модули проекта интегрированы. Полный
|
||
manual-test checklist смотрите в [`MANUAL-TESTS.md`](../../MANUAL-TESTS.md)
|
||
или `MANUAL-TESTS.md` в корне.
|
||
|
||
## Где скачать
|
||
|
||
- **Source**: `git clone https://git.binom.pw/subochev/agentik`
|
||
- **Fatjar**: Gitea CI artifacts (через `.gitea/workflows/release.yml`
|
||
на tag `v*`) или собирается через `./gradlew :standalone:shadowJar`.
|
||
|
||
## Версии
|
||
|
||
Все `gradle/libs.versions.toml`. Поднять версию → release через
|
||
`git tag v0.2.0 && git push --tags` → CI собирает все KMP-таргеты
|
||
публикует артефакты.
|