Files
microdao-daarion/CURSOR-QUICK-TASKS.md
Apple 4601c6fca8 feat: add Vision Encoder service + Vision RAG implementation
- 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 
2025-11-17 05:24:36 -08:00

5.7 KiB
Raw Blame History

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
  • Виводить інструкції для наступних кроків

Використання:

./scripts/add-agent.sh <AGENT_NAME> <BOT_TOKEN> <PROMPT_FILE>

Приклад:

./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

Використання:

./scripts/set-webhook.sh <agent_id> <bot_token> [webhook_base_url]

Приклад:

./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

Використання:

# На сервері як root
sudo ./scripts/setup-nginx-gateway.sh gateway.daarion.city admin@daarion.city 9300

Що робить register-agent-webhook.sh:

  • Реєструє webhook для будь-якого агента через Telegram API
  • Автоматично перевіряє статус webhook
  • Підтримка jq для красивого виводу

Використання:

./scripts/register-agent-webhook.sh <agent_id> <bot_token> [domain]

Приклад:

./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 агента

Перевірка виконання

Після виконання всіх завдань перевірте:

# Перевірте наявність скриптів
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