Übersicht über den KI-Agenten

Der Vartovii KI-Agent ("Vartovii" - Wächter auf Ukrainisch) ist ein intelligenter Assistent, der auf Google Gemini 2.5 Flash mit Function Calling-Fähigkeiten basiert.

🤖 Was ist der KI-Agent?

Der KI-Agent ist eine Konversationsschnittstelle, die Folgendes kann:

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

🧠 Technologie-Stack

Komponente	Technologie	Zweck
LLM	Gemini 2.5 Flash	Verständnis natürlicher Sprache
Function Calling	Vertex AI	Werkzeugausführung
RAG	Vertex AI RAG Engine	Dokumentationssuche
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 das Unternehmen BMW"
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 Tools

Der Agent hat Zugriff auf 12 spezialisierte Tools:

Corporate Intelligence (6 Tools)

Tool	Zweck	Beispiel-Trigger
search_company	Unternehmen in der Datenbank finden	"Finde BMW"
get_trust_score	Detaillierten Trust Score abrufen	"Was 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"

Crypto Intelligence (2 Tools)

Tool	Zweck	Beispiel-Trigger
search_crypto_projects	Krypto-Projekt finden (CoinGecko)	"Finde Solana"
get_crypto_trust_score	Crypto Trust Score abrufen	"Trust Score für ETH"

Forensic Agent (4 Tools)

Tool	Zweck	Beispiel-Trigger
check_wallet	ETH-Guthaben für Wallet prüfen	"Guthaben von 0xd8dA..."
get_transaction_history	Transaktionshistorie der Wallet abrufen	"Transaktionen für 0xd8dA..."
get_token_holders	Verteilung der Token-Inhaber analysieren	"Top-Inhaber von USDT"
get_contract_info	Smart-Contract-Details überprüfen	"Ist 0xdAC17F... ERC20?"

→ Siehe Tool-Referenz für die vollständige Dokumentation.

🔍 Auto-Erkennung

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

Englische Schlüsselwörter

• Unternehmen: company, employer, find, search, reviews
• Krypto: crypto, token, coin, price, market cap, project
• Forensisch/On-Chain: wallet, address, balance, transaction, holder, contract, 0x
• Analyse: analyze, scrape, trust score, rating
• Vergleich: compare, versus, vs, battle

Ukrainische Schlüsselwörter

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

💬 Chat-Widget

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

Funktionen

• Standardmäßig englische Benutzeroberfläche - Chat-Schnittstelle vollständig auf Englisch lokalisiert
• Mehrsprachige Antworten: Englisch, Ukrainisch, Deutsch (automatisch erkannt)
• Konversationsverlauf: Kontext über Nachrichten hinweg beibehalten
• Markdown-Rendering: Tabellen, Codeblöcke, Listen
• Tool-Status-Visualisierung: Pizza Tracker zeigt aktive Tools an

📊 Pizza Tracker

Wenn der Agent Tools 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 Tools, das ausgeführt wird
• Übergebene Parameter
• Ausführungsstatus (ausstehend/abgeschlossen)
• Zusammenfassung des Ergebnisses

🔐 Sicherheit

• API-Schlüssel erforderlich: Agent-Tool-Endpunkte benötigen X-API-Key Header
• Rate Limited: 5 Anfragen/Minute für Analyse-Tools
• Audit Logged: Alle Tool-Aufrufe werden zur Sicherheit protokolliert

🚀 Erste Schritte

Über das 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 Tools aus

Über die 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 Tool-Referenz für eine detaillierte Dokumentation jedes Tools.