AgentSkillsCN

RAG Knowledge Grid

管理 AI 助手维克托的知识库（API 规则、文档资料、运行逻辑）。

SKILL.md
--- frontmatter
name: RAG Knowledge Grid
description: Управление базой знаний AI-ассистента Виктора (правила API, документация, логика работы).
triggers:
  - 'Как работает [функция]?'
  - 'Обнови базу знаний'
  - 'Проиндексируй новый файл'
  - 'Виктор, откуда ты это знаешь?'

📚 RAG Knowledge Skill

🎯 Цель (Objective)

Обеспечение Агента (Виктора) актуальной контекстной информацией для точных ответов на технические и бизнес-вопросы.

🛠️ Инструментарий (Tools & Scripts)

  • •scripts/rag-migrate.ts: Миграция схемы (автоматическое определение размерности).
  • •scripts/diagnostic.ts: Проверка подключения к векторной БД и целостности конфигурации.
  • •scripts/rebuild-vector-store.ts: Полная переиндексация базы знаний.
  • •scripts/test-rag-system.ts: Полная проверка работоспособности RAG (Step-by-step).
  • •src/infrastructure/rag/IngestionPipeline.ts: Ядро логики обработки документов.
  • •src/infrastructure/rag/VectorStore.ts: Слой взаимодействия с векторной БД.

📋 Протокол Действий (Workflow)

  1. •Миграция: Выполнить npx tsx scripts/rag-migrate.ts для создания таблицы с нужной размерностью (HF=1024, Gemini=768).
  2. •Индексация: Выполнить npx tsx scripts/rebuild-vector-store.ts для загрузки данных из docs/knowledge_base/.
  3. •Верификация: Запустить npx tsx scripts/test-rag-system.ts для проверки поиска и задержек.
  4. •Использование: В специалистах использовать vectorStore.search(query, { namespace: '...' }).
  5. •Обновление: При изменении документации в docs/knowledge_base/ повторить шаг 2.

⚠️ Ограничения (Constraints)

  • •ЗАПРЕЩЕНО использовать размерность вектора, не соответствующую провайдеру (HuggingFace=1024, Gemini=768, OpenAI=1536).
  • •ЗАПРЕЩЕНО индексировать файлы, содержащие секреты.
  • •Максимальный размер чанка — 1000 токенов для сохранения семантики.
  • •Всегда указывать source_file в метаданных.
  • •При ошибках соединения с БД проверять статус Neon Postgres.