AI Agent Tools Reference

Complete reference for all 6 AI Agent tools available in Sentry Analytics.

Tool Summary

Tool	Purpose	Parameters
search_company	Find company in database	company_name, country?
get_trust_score	Detailed Trust Score breakdown	company_name
list_companies	Top employers ranking	country?, limit?, sort_by?
compare_companies	Compare two employers	company1, company2
run_analysis	Start analysis for new company	company_name, country?
get_company_reviews	Show sample reviews	company_name, sentiment?, limit?

---

1. search_company

Search for a company in the database.

Parameters

Name	Type	Required	Description
company_name	string	✅	Company name to search
country	string	❌	Country code (de, at, ch)

Example

User: "Find BMW company"

Response

{
  "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

Get detailed Trust Score with breakdown.

Parameters

Name	Type	Required	Description
company_name	string	✅	Company name

Response

{
  "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

Get top employers ranked by Trust Score.

Parameters

Name	Type	Required	Default	Description
country	string	❌	all	Filter by country
limit	integer	❌	10	Number of companies
sort_by	string	❌	trust_score	Sorting field

Example

User: "Show top 5 companies"

Response

Returns list of companies with:

• Company name
• Trust Score
• Review count
• Average rating

---

4. compare_companies

Compare two employers side-by-side.

Parameters

Name	Type	Required	Description
company1	string	✅	First company
company2	string	✅	Second company

Example

User: "Compare BMW and Audi"

Response

{
  "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

Start data collection and analysis for a NEW company.

Magic Search

This tool triggers our "Magic Search" system that searches Kununu, starts scraping from multiple sources, and creates a full analysis.

Parameters

Name	Type	Required	Default	Description
company_name	string	✅	-	Company to analyze
country	string	❌	de	Country code

Example

User: "Analyze Spotify company"

Response

{
  "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."
}

Job Types Started

1. Kununu - Main review source
2. Google Reviews - Business ratings
3. Reddit - Employee discussions
4. Indeed Vacancies - Job market data

---

6. get_company_reviews

Get sample employee reviews.

Parameters

Name	Type	Required	Default	Description
company_name	string	✅	-	Company name
sentiment	string	❌	all	Filter: positive, negative, all
limit	integer	❌	5	Number of reviews (max 10)

Example

User: "Show reviews for BMW"

Response

{
  "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
  }
}

---

Trigger Keywords

The AI Agent automatically activates when it detects these keywords:

English

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

Ukrainian

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