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

Sentry Analytics AI Agent ("Вартовий") — це інтелектуальний помічник, що працює на базі 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. Агент відповідає: Відформатоване повідомлення з інформацією про компанію

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

Агент має доступ до 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"

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

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

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

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

• Пошук: company, employer, find, search, look for
• Trust Score: trust score, rating, score, reliability
• Порівняння: compare, versus, vs, battle
• Аналіз: analyze, scrape, collect data
• Відгуки: reviews, feedback, opinions

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

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

💬 Віджет чату

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

Функції

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

📊 Pizza Tracker

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

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

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

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

🔐 Безпека

• Потрібен API ключ: Кінцеві точки інструментів агента вимагають заголовок 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"}}
  ]
}

---

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