Inicio rápido En desarrollo

Pon en marcha tu primer Agente Kova en 5 minutos.

5 minutosTiempo estimado

3 formasMétodos de instalación

CeroDependencias externas

Requisitos previos

Docker o Rust 1.93+ (a elegir) · Lurus API Key (cómo obtenerla) · 8 GB+ de memoria (recomendado) · conocimientos básicos de terminal. Tiempo estimado: 5 minutos.

Instalación

Instalar Kova

Docker (recomendado), binario precompilado o compilación desde el código fuente; elige una opción.

Elige un método de instalación

docker run -d \
  --name kova \
  -p 8080:8080 \
  -v kova-data:/data \
  -e LURUS_API_KEY=sk-your-key \
  ghcr.io/hanmahong5-arch/kova:latest

Descarga el binario precompilado desde GitHub Releases:

Plataforma	Archivo
Linux x86_64	`kova-linux-amd64`
macOS (Apple Silicon)	`kova-darwin-arm64`
macOS (Intel)	`kova-darwin-amd64`
Windows	`kova-windows-amd64.exe`

Requisito de versión de Rust

Kova requiere Rust 1.93+ (Edition 2024). Se recomienda usar rustup para gestionar la cadena de herramientas.

Configuración

Crea el archivo de configuración kova.toml:

toml

[server]
port = 8080
data_dir = "./data"

[llm]
# 通过 Lurus API 接入所有模型
provider = "openai-compatible"
base_url = "https://hub.lurus.cn/v1"
api_key = "sk-your-lurus-key"
default_model = "deepseek-chat"

[wal]
# WAL 持久化配置
enabled = true
sync_mode = "normal"  # "normal" | "full" (每次写入 fsync)

[security]
# 可选：启用 WAL 加密
# encrypt = true
# encrypt_algorithm = "aes-256-gcm"

Primeros pasos

Inicia tu primer Agente

Elige entre REST / Rust SDK / CLI para crear un Agente, enviar tareas y ver la ejecución en streaming.

Una vez iniciado, elige el método de acceso que prefieras para crear y ejecutar tu primer Agente (consulta los endpoints completos en la Referencia de la API).

Flujo de trabajo

Crear un flujo de trabajo

Un flujo de trabajo encadena varios pasos en una canalización de ejecución ordenada (los pasos se pasan valores entre sí mediante variables de plantilla, véase el ejemplo a continuación):

bash

curl -X POST http://localhost:8080/api/v1/workflows \
  -H "Content-Type: application/json" \
  -d '{ "name": "content-pipeline", "steps": [
    { "name": "research", "agent": "researcher", "prompt": "研究主题：{{input.topic}}" },
    { "name": "write", "agent": "writer", "prompt": "基于研究报告撰写博客：\n{{steps.research.output}}" },
    { "name": "review", "agent": "editor", "prompt": "审校并优化：\n{{steps.write.output}}" }
  ] }'

# 触发
curl -X POST http://localhost:8080/api/v1/workflows/content-pipeline/run \
  -H "Content-Type: application/json" -d '{"input": {"topic": "边缘计算与 AI 推理"}}'

Persistencia

Verificar la persistencia

Mata el proceso y, tras reiniciar, la tarea se recupera automáticamente desde el punto de interrupción del WAL.

Prueba la capacidad de recuperación ante fallos de Kova:

Inicia una tarea larga

bash

kova agent run researcher "写一份 5000 字的深度报告"

Mientras la tarea se ejecuta, termina el proceso por la fuerza
bash
```
kill -9 $(pgrep kova)
```
1
Reinicia Kova
bash
```
./kova serve
```
1
Consulta el estado de la tarea — se recupera automáticamente desde el punto de interrupción
bash
```
kova task status
```
1

Por qué puede recuperarse

Antes de ejecutar cada paso se escribe primero en el WAL (con verificación CRC32). Cuando el proceso falla, los pasos cuya finalización no se confirmó se reproducen desde el punto de interrupción tras el reinicio, sin volver a llamar al LLM ni perder progreso. Más detalles en Conceptos básicos.

Siguientes pasos

Próximos pasos

Conceptos básicos — Comprende en profundidad la arquitectura de Agentes, Workflows y WAL Referencia de la API — Lista completa de endpoints de la REST API Lurus API — Conoce la pasarela LLM subyacente

Inicio rápido En desarrollo ​