AI Agent Übersicht

Der Sentry Analytics AI Agent ("Вартовий" - Wächter auf Ukrainisch) ist ein intelligenter Assistent, der von Google Gemini 2.5 Flash mit Function Calling-Fähigkeiten angetrieben wird.

🤖 Was ist der AI Agent?

Der AI Agent ist eine konversationelle Schnittstelle, die kann:

• Unternehmen suchen in unserer Datenbank
• Trust Scores abrufen mit detaillierten Aufschlüsselungen
• Arbeitgeber vergleichen nebeneinander
• Analyse starten für neue Unternehmen (Magic Search)
• Bewertungen anzeigen, gefiltert nach Stimmung
• Fragen beantworten zur Plattform

🧠 Technology Stack

Komponente	Technology	Zweck
LLM	Gemini 2.5 Flash	Verständnis natürlicher Sprache
Function Calling	Vertex AI	Werkzeugausführung
RAG	Vertex AI RAG Engine	Dokumentensuche
Grounding	Google Search	Echtzeit-Webinformationen

🔧 Funktionsweise

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

Beispielablauf

1. Benutzer sagt: "Finde BMW Unternehmen"
2. Agent erkennt: Schlüsselwort "find" + "company" = search_company Werkzeug
3. Agent führt aus: search_company(company_name="BMW")
4. API gibt zurück: Unternehmensdaten mit Trust Score
5. Agent antwortet: Formatierte Nachricht mit Unternehmensinformationen

🛠️ Verfügbare Werkzeuge

Der Agent hat Zugriff auf 6 spezialisierte Werkzeuge:

Werkzeug	Zweck	Beispielauslöser
search_company	Unternehmen in der Datenbank finden	"Finde BMW"
get_trust_score	Detaillierten Trust Score abrufen	"Wie ist der Trust Score von BMW?"
list_companies	Top-Arbeitgeber anzeigen	"Zeige die Top 10 Unternehmen"
compare_companies	Zwei Arbeitgeber vergleichen	"Vergleiche BMW und Audi"
run_analysis	Neue Unternehmensanalyse starten	"Analysiere Spotify"
get_company_reviews	Beispielbewertungen anzeigen	"Zeige BMW Bewertungen"

→ Siehe Werkzeugreferenz für die vollständige Dokumentation.

🔍 Auto-Erkennung

Der Agent erkennt automatisch anhand von Schlüsselwörtern, wann Werkzeuge verwendet werden sollen:

Englische Schlüsselwörter

• Suchen: company, employer, find, search, look for
• Trust Score: trust score, rating, score, reliability
• Vergleichen: compare, versus, vs, battle
• Analyse: analyze, scrape, collect data
• Bewertungen: reviews, feedback, opinions

Ukrainische Schlüsselwörter

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

💬 Chat Widget

Der AI Agent ist über einen schwebenden Chat-Button (💬) in der unteren rechten Ecke des Dashboards zugänglich.

Funktionen

• Mehrsprachige Unterstützung: Englisch, Ukrainisch, Deutsch
• Gesprächsverlauf: Kontext wird über Nachrichten hinweg beibehalten
• Markdown-Rendering: Tabellen, Code-Blöcke, Listen
• Visualisierung des Werkzeugstatus: Pizza Tracker zeigt aktive Werkzeuge an

📊 Pizza Tracker

Wenn der Agent Werkzeuge verwendet, zeigt der Pizza Tracker den Fortschritt in Echtzeit an:

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

Der Tracker zeigt an:

• Name des ausgeführten Werkzeugs
• Übergebene Parameter
• Ausführungsstatus (ausstehend/abgeschlossen)
• Zusammenfassung des Ergebnisses

🔐 Sicherheit

• API-Schlüssel erforderlich: Agent-Tool-Endpunkte erfordern den X-API-Key Header
• Ratenbegrenzt: 5 Anfragen/Minute für Analysetools
• Audit-Logging: Alle Werkzeugaufrufe werden zur Sicherheit protokolliert

🚀 Erste Schritte

Über Chat Widget

1. Klicken Sie auf den 💬 Button im Dashboard
2. Geben Sie Ihre Frage in natürlicher Sprache ein
3. Der Agent erkennt die Absicht und führt die entsprechenden Werkzeuge aus

Über API

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

📝 Antwortformat

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

---

Siehe Werkzeugreferenz für eine detaillierte Dokumentation jedes Werkzeugs.