4601c6fca8
- Vision Encoder Service (OpenCLIP ViT-L/14, GPU-accelerated)
- FastAPI app with text/image embedding endpoints (768-dim)
- Docker support with NVIDIA GPU runtime
- Port 8001, health checks, model info API
- Qdrant Vector Database integration
- Port 6333/6334 (HTTP/gRPC)
- Image embeddings storage (768-dim, Cosine distance)
- Auto collection creation
- Vision RAG implementation
- VisionEncoderClient (Python client for API)
- Image Search module (text-to-image, image-to-image)
- Vision RAG routing in DAGI Router (mode: image_search)
- VisionEncoderProvider integration
- Documentation (5000+ lines)
- SYSTEM-INVENTORY.md - Complete system inventory
- VISION-ENCODER-STATUS.md - Service status
- VISION-RAG-IMPLEMENTATION.md - Implementation details
- vision_encoder_deployment_task.md - Deployment checklist
- services/vision-encoder/README.md - Deployment guide
- Updated WARP.md, INFRASTRUCTURE.md, Jupyter Notebook
- Testing
- test-vision-encoder.sh - Smoke tests (6 tests)
- Unit tests for client, image search, routing
- Services: 17 total (added Vision Encoder + Qdrant)
- AI Models: 3 (qwen3:8b, OpenCLIP ViT-L/14, BAAI/bge-m3)
- GPU Services: 2 (Vision Encoder, Ollama)
- VRAM Usage: ~10 GB (concurrent)
Status: Production Ready ✅
147 lines
5.7 KiB
Markdown
147 lines
5.7 KiB
Markdown
# Cursor Quick Tasks - Setup Telegram Bot Agents
|
||
|
||
Цей файл містить 4 завдання для налаштування системи Telegram бот-агентів у DAGI Gateway.
|
||
|
||
---
|
||
|
||
## Завдання 1: Створити скрипт для додавання нового агента
|
||
|
||
**Файл:** `scripts/add-agent.sh`
|
||
|
||
**Опис:** Універсальний скрипт для додавання нового Telegram бот-агента до DAGI Gateway.
|
||
|
||
**Що робить:**
|
||
- Оновлює `.env` з конфігурацією агента
|
||
- Генерує код для додавання до `gateway-bot/http_api.py`
|
||
- Виводить інструкції для наступних кроків
|
||
|
||
**Використання:**
|
||
```bash
|
||
./scripts/add-agent.sh <AGENT_NAME> <BOT_TOKEN> <PROMPT_FILE>
|
||
```
|
||
|
||
**Приклад:**
|
||
```bash
|
||
./scripts/add-agent.sh Helion 8112062582:AAG... helion_prompt.txt
|
||
```
|
||
|
||
---
|
||
|
||
## Завдання 2: Створити скрипт для встановлення webhook
|
||
|
||
**Файл:** `scripts/set-webhook.sh`
|
||
|
||
**Опис:** Скрипт для встановлення Telegram webhook для агента.
|
||
|
||
**Що робить:**
|
||
- Перевіряє обов'язкові параметри (agent_id та bot_token)
|
||
- Формує повний URL для webhook
|
||
- Відправляє запит до Telegram API для встановлення webhook
|
||
- Показує команду для перевірки статусу webhook
|
||
|
||
**Використання:**
|
||
```bash
|
||
./scripts/set-webhook.sh <agent_id> <bot_token> [webhook_base_url]
|
||
```
|
||
|
||
**Приклад:**
|
||
```bash
|
||
./scripts/set-webhook.sh helion 8112062582:AAG... https://api.microdao.xyz
|
||
```
|
||
|
||
---
|
||
|
||
## Завдання 3: Створити шаблон для агента
|
||
|
||
**Файл:** `templates/agent_template.py`
|
||
|
||
**Опис:** Шаблон коду для додавання нового агента до `http_api.py`.
|
||
|
||
**Що містить:**
|
||
- Конфігурацію змінних середовища для агента
|
||
- Функцію завантаження промпту з файлу
|
||
- Webhook-ендпоінт для Telegram
|
||
- Інтеграцію з Memory Service для збереження контексту
|
||
- Інтеграцію з Router для обробки повідомлень
|
||
- Обробку помилок з відправкою повідомлень користувачу
|
||
|
||
**Плейсхолдери для заміни:**
|
||
- `{AGENT_NAME}` — ім'я агента у верхньому регістрі (для змінних)
|
||
- `{agent_id}` — ідентифікатор агента у нижньому регістрі (для URL та функцій)
|
||
- `{agent_display_name}` — відображуване ім'я агента
|
||
- `{prompt_file}` — назва файлу з промптом
|
||
|
||
---
|
||
|
||
## Завдання 4: Створити production-рішення для масштабування
|
||
|
||
**Файли:**
|
||
- `scripts/setup-nginx-gateway.sh` — налаштування nginx reverse proxy з Let's Encrypt
|
||
- `scripts/register-agent-webhook.sh` — реєстрація webhook для будь-якого агента
|
||
|
||
**Опис:** Production-ready рішення для масштабування тисяч агентів.
|
||
|
||
**Що робить `setup-nginx-gateway.sh`:**
|
||
- Встановлює certbot для Let's Encrypt
|
||
- Отримує SSL сертифікат для домену
|
||
- Налаштовує nginx reverse proxy з HTTPS
|
||
- Налаштовує автоматичне оновлення сертифікатів
|
||
- Підтримує всіх агентів на підшляхах: `/{agent_id}/telegram/webhook`
|
||
|
||
**Використання:**
|
||
```bash
|
||
# На сервері як root
|
||
sudo ./scripts/setup-nginx-gateway.sh gateway.daarion.city admin@daarion.city 9300
|
||
```
|
||
|
||
**Що робить `register-agent-webhook.sh`:**
|
||
- Реєструє webhook для будь-якого агента через Telegram API
|
||
- Автоматично перевіряє статус webhook
|
||
- Підтримка jq для красивого виводу
|
||
|
||
**Використання:**
|
||
```bash
|
||
./scripts/register-agent-webhook.sh <agent_id> <bot_token> [domain]
|
||
```
|
||
|
||
**Приклад:**
|
||
```bash
|
||
./scripts/register-agent-webhook.sh helion 8112062582:AAG... gateway.daarion.city
|
||
```
|
||
|
||
---
|
||
|
||
## Додаткові файли (створені автоматично)
|
||
|
||
- `scripts/setup-ngrok.sh` — налаштування ngrok тунелю (для тестування)
|
||
- `scripts/setup-cloudflare-tunnel.sh` — налаштування CloudFlare Tunnel
|
||
- `scripts/README-TUNNELS.md` — документація з налаштування тунелів
|
||
- `scripts/QUICK-SETUP.md` — швидкий гайд
|
||
- `docs/HELION-QUICKSTART.md` — документація для Helion агента
|
||
|
||
---
|
||
|
||
## Перевірка виконання
|
||
|
||
Після виконання всіх завдань перевірте:
|
||
|
||
```bash
|
||
# Перевірте наявність скриптів
|
||
ls -lh scripts/add-agent.sh scripts/set-webhook.sh scripts/setup-nginx-gateway.sh scripts/register-agent-webhook.sh
|
||
|
||
# Перевірте наявність шаблону
|
||
ls -lh templates/agent_template.py
|
||
|
||
# Перевірте права на виконання
|
||
chmod +x scripts/*.sh
|
||
```
|
||
|
||
---
|
||
|
||
## Наступні кроки
|
||
|
||
1. Додайте агента: `./scripts/add-agent.sh Helion <TOKEN> helion_prompt.txt`
|
||
2. Налаштуйте HTTPS gateway: `sudo ./scripts/setup-nginx-gateway.sh gateway.daarion.city admin@daarion.city 9300`
|
||
3. Зареєструйте webhook: `./scripts/register-agent-webhook.sh helion <TOKEN> gateway.daarion.city`
|
||
4. Перевірте: `curl https://gateway.daarion.city/health`
|