Довідник інструментів AI агента

Повний довідник по всіх 6 інструментах AI агента, доступних в Sentry Analytics.

Короткий опис інструментів

Інструмент	Призначення	Параметри
search_company	Знайти компанію в базі даних	company_name, country?
get_trust_score	Детальна розбивка Trust Score	company_name
list_companies	Рейтинг найкращих роботодавців	country?, limit?, sort_by?
compare_companies	Порівняти двох роботодавців	company1, company2
run_analysis	Розпочати аналіз для нової компанії	company_name, country?
get_company_reviews	Показати зразки відгуків	company_name, sentiment?, limit?

---

1. search_company

Пошук компанії в базі даних.

Параметри

Назва	Тип	Обов'язковий	Опис
company_name	string	✅	Назва компанії для пошуку
country	string	❌	Код країни (de, at, ch)

Приклад

User: "Find BMW company"

Відповідь

{
  "found": true,
  "company_name": "BMW",
  "trust_score": 71,
  "avg_rating": 3.97,
  "review_count": 5621,
  "sentiment_positive": 50,
  "sentiment_negative": 50,
  "data_freshness": "fresh (< 7 days)"
}

---

2. get_trust_score

Отримати детальний Trust Score з розбивкою.

Параметри

Назва	Тип	Обов'язковий	Опис
company_name	string	✅	Назва компанії

Відповідь

{
  "company_name": "BMW",
  "trust_score": 71,
  "risk_level": "MEDIUM",
  "breakdown": {
    "rating_quality": 23.8,
    "sentiment": 12.5,
    "volume": 20,
    "consistency": 10,
    "recency": 5
  }
}

---

3. list_companies

Отримати рейтинг найкращих роботодавців за Trust Score.

Параметри

Назва	Тип	Обов'язковий	За замовчуванням	Опис
country	string	❌	all	Фільтрувати за країною
limit	integer	❌	10	Кількість компаній
sort_by	string	❌	trust_score	Поле для сортування

Приклад

User: "Show top 5 companies"

Відповідь

Повертає список компаній із:

• Назва компанії
• Trust Score
• Кількість відгуків
• Середній рейтинг

---

4. compare_companies

Порівняти двох роботодавців.

Параметри

Назва	Тип	Обов'язковий	Опис
company1	string	✅	Перша компанія
company2	string	✅	Друга компанія

Приклад

User: "Compare BMW and Audi"

Відповідь

{
  "company1": {
    "name": "BMW",
    "trust_score": 71,
    "review_count": 5621,
    "avg_rating": 3.97
  },
  "company2": {
    "name": "Audi",
    "trust_score": 57,
    "review_count": 1243,
    "avg_rating": 3.45
  },
  "winner": "BMW",
  "score_difference": 14
}

---

5. run_analysis

Розпочати збір даних та аналіз для НОВОЇ компанії.

Magic Search

Цей інструмент запускає нашу систему "Magic Search", яка шукає на Kununu, починає збір даних з кількох джерел і створює повний аналіз.

Параметри

Назва	Тип	Обов'язковий	За замовчуванням	Опис
company_name	string	✅	-	Компанія для аналізу
country	string	❌	de	Код країни

Приклад

User: "Analyze Spotify company"

Відповідь

{
  "action": "analysis_started",
  "company_name": "Spotify",
  "company_slug": "spotify-ab1",
  "scraping_jobs": ["job-1", "job-2", "job-3", "job-4"],
  "message": "🚀 Analysis started! Check back in 5-10 minutes."
}

Запущені типи завдань

1. Kununu - Основне джерело відгуків
2. Google Reviews - Бізнес-рейтинги
3. Reddit - Обговорення співробітників
4. Indeed Vacancies - Дані ринку праці

---

6. get_company_reviews

Отримати зразки відгуків співробітників.

Параметри

Назва	Тип	Обов'язковий	За замовчуванням	Опис
company_name	string	✅	-	Назва компанії
sentiment	string	❌	all	Фільтр: позитивні, негативні, всі
limit	integer	❌	5	Кількість відгуків (макс. 10)

Приклад

User: "Show reviews for BMW"

Відповідь

{
  "company_name": "BMW",
  "reviews": [
    {
      "text": "👍 Great work-life balance, interesting projects...",
      "rating": 4.5,
      "sentiment": "POSITIVE",
      "source": "kununu"
    },
    {
      "text": "👎 Management could be better, communication issues...",
      "rating": 2.5,
      "sentiment": "NEGATIVE",
      "source": "kununu"
    }
  ],
  "summary": {
    "total": 5,
    "positive": 3,
    "negative": 2
  }
}

---

Ключові слова-тригери

AI Агент автоматично активується, коли виявляє ці ключові слова:

Англійська

• company, employer, find, search, compare
• trust score, rating, top, best, worst
• analyze, reviews, analysis

Українська

• компанія, роботодавець, знайди, пошук
• траст скор, рейтинг, топ, порівняй
• проаналізуй, відгуки, аналіз