Огляд AI Агента

Vartovii AI Agent ("Vartovii" - Guardian (Охоронець) українською) – це інтелектуальний помічник на базі Google Gemini 2.5 Flash з можливостями Function Calling.

🤖 Що таке AI Агент?

AI Агент — це розмовний інтерфейс, який може:

• Шукати компанії в нашій базі даних
• Отримувати Trust Scores з детальним розбиттям
• Порівнювати роботодавців поруч
• Розпочинати аналіз для нових компаній (Magic Search)
• Показувати відгуки, відфільтровані за тональністю
• Відповідати на запитання про платформу

🧠 Стек Технологій

Компонент	Технологія	Призначення
LLM	Gemini 2.5 Flash	Розуміння природної мови
Function Calling	Vertex AI	Виконання інструментів
RAG	Vertex AI RAG Engine	Пошук документації
Grounding	Google Search	Веб-інформація в реальному часі

🔧 Як це працює

User Message → Gemini 2.5 → Function Detection → Tool Execution → Response
                    ↓
              Keywords detected?
                ↓         ↓
            Yes: Tool Call    No: Direct Answer
                ↓
          Execute Tool (API call)
                ↓
          Format Response

Приклад Робочого Процесу

1. Користувач каже: "Find BMW company"
2. Агент виявляє: Ключове слово "find" + "company" = інструмент search_company
3. Агент виконує: search_company(company_name="BMW")
4. API повертає: Дані компанії з Trust Score
5. Агент відповідає: Форматоване повідомлення з інформацією про компанію

🛠️ Доступні Інструменти

Агент має доступ до 12 спеціалізованих інструментів:

Корпоративний Аналіз (6 інструментів)

Інструмент	Призначення	Приклад Тригера
search_company	Знайти компанію в базі даних	"Find BMW"
get_trust_score	Отримати детальний Trust Score	"What's BMW's Trust Score?"
list_companies	Показати провідних роботодавців	"Show top 10 companies"
compare_companies	Порівняти двох роботодавців	"Compare BMW and Audi"
run_analysis	Розпочати новий аналіз компанії	"Analyze Spotify"
get_company_reviews	Показати приклади відгуків	"Show BMW reviews"

Крипто Аналіз (2 інструменти)

Інструмент	Призначення	Приклад Тригера
search_crypto_projects	Знайти криптопроект (CoinGecko)	"Find Solana"
get_crypto_trust_score	Отримати Crypto Trust Score	"Trust Score for ETH"

Форензік Агент (4 інструменти)

Інструмент	Призначення	Приклад Тригера
check_wallet	Перевірити баланс ETH для гаманця	"Balance of 0xd8dA..."
get_transaction_history	Отримати історію транзакцій гаманця	"Transactions for 0xd8dA..."
get_token_holders	Аналізувати розподіл власників токенів	"Top holders of USDT"
get_contract_info	Перевірити деталі смарт-контракту	"Is 0xdAC17F... ERC20?"

→ Дивіться Довідник Інструментів для повної документації.

🔍 Автоматичне Виявлення

Агент автоматично визначає, коли використовувати інструменти, на основі ключових слів:

Англійські Ключові Слова

• Corporate: company, employer, find, search, reviews
• Crypto: crypto, token, coin, price, market cap, project
• Forensic/On-Chain: wallet, address, balance, transaction, holder, contract, 0x
• Analysis: analyze, scrape, trust score, rating
• Comparison: compare, versus, vs, battle

Українські Ключові Слова

• Корпоративні: компанія, роботодавець, відгуки, рейтинг
• Крипто: крипта, токен, монета, ціна, проект
• Форензік: гаманець, адреса, баланс, транзакції, контракт
• Аналіз: проаналізуй, збери дані, траст скор
• Порівняння: порівняй, проти, vs

💬 Віджет Чату

AI Агент доступний через плаваючу кнопку чату (💬) у нижньому правому куті панелі керування.

Особливості

• Англійський інтерфейс за замовчуванням - Інтерфейс чату повністю локалізовано англійською мовою
• Багатомовні відповіді: англійська, українська, німецька (автоматичне виявлення)
• Історія розмов: Контекст зберігається між повідомленнями
• Рендеринг Markdown: Таблиці, блоки коду, списки
• Візуалізація статусу інструментів: Pizza Tracker показує активні інструменти

📊 Pizza Tracker

Коли агент використовує інструменти, Pizza Tracker показує прогрес у реальному часі:

🔍 search_company → Searching for "BMW"...
✅ Found: BMW (Trust Score: 71)

Трекер відображає:

• Назва інструменту, що виконується
• Передані параметри
• Статус виконання (в очікуванні/завершено)
• Зведення результатів

🔐 Безпека

• Потрібен API Key: Кінцеві точки інструментів Агента вимагають заголовок X-API-Key
• Обмеження частоти запитів: 5 запитів/хвилину для інструментів аналізу
• Аудит журналюється: Усі виклики інструментів реєструються для безпеки

🚀 Початок Роботи

Через Віджет Чату

1. Натисніть кнопку 💬 на панелі керування
2. Введіть своє запитання природною мовою
3. Агент виявить намір і виконає відповідні інструменти

Через API

curl -X POST https://sentryanalytic.com/api/ai/chat \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Find BMW company",
    "language": "auto"
  }'

📝 Формат Відповіді

{
  "response": "BMW is a German automotive company with a Trust Score of 71/100...",
  "status": "ok",
  "grounded": false,
  "rag_used": false,
  "tools_used": true,
  "tool_calls": [
    { "name": "search_company", "args": { "company_name": "BMW" } }
  ]
}

---

Дивіться Довідник Інструментів для детальної документації кожного інструменту.