Skip to content

README.md

Latest commit

 

History

History
234 lines (158 loc) · 6.01 KB

README.md

File metadata and controls

234 lines (158 loc) · 6.01 KB

Recherche-Agent für Websuche mit LLM-Analyse

Ein intelligenter Recherche-Agent, der echte Google-Suchergebnisse über die Serper API abruft und mit Hilfe von Ollama/LLM analysiert und zusammenfasst.

🚀 Schnellstart

Schritt 1: Batch-Datei ausführen

start_agent.bat

Dann wählen Sie eine Option:

  • [1] Agent mit Standardparametern starten (Suche: "KI Nachhaltigkeit", 3 Ergebnisse)
  • [2] Agent mit eigenen Parametern starten (eigene Suchanfrage und Anzahl)
  • [3] Beenden

Schritt 2: Ergebnisse prüfen

Die Ergebnisse werden im responses/ Ordner gespeichert.

📋 Voraussetzungen

1. Node.js und npm

  • Node.js (Version 18 oder höher)
  • npm (wird mit Node.js installiert)

Installation: Laden Sie Node.js von nodejs.org herunter.

2. TSX (TypeScript Executor)

npm install -g tsx

3. Benötigte Node-Pakete

npm install dotenv

4. Ollama (Local LLM)

  • Ollama muss installiert und gestartet sein
  • Installation: ollama.com
  • Empfohlenes Modell: llama3.2 (beste Qualität für deutsche Texte)
  • Konfiguration: Das Modell kann über die .env-Datei angepasst werden
# Ollama installieren und Modell laden
ollama pull llama3.2

# Weitere empfohlene Modelle für deutsche Texte:
ollama pull mistral
ollama pull llama3

5. Serper API Key

  • Kostenlosen API-Key von serper.dev erhalten
  • Der Key ist bereits in der .env Datei konfiguriert
  • Wichtig: Halten Sie Ihren API-Key geheim!

🔧 Konfiguration

Environment-Variablen (.env)

Die .env Datei enthält bereits die notwendigen Konfigurationen:

# Serper API Configuration  
SERPER_API_KEY=ihr_api_key_hier

# Agent Configuration
MODEL_NAME=llama3.2

Konfigurierbare Optionen:

  • SERPER_API_KEY: Ihr API-Schlüssel für die Serper-API
  • MODEL_NAME: Das zu verwendende Ollama-Modell (Standard: llama3.2)

Modell-Wechsel

Sie können einfach das verwendete LLM-Modell ändern, ohne den Code zu modifizieren:

# Beispiele für verschiedene Modelle:
MODEL_NAME=llama3.2        # Beste Qualität für deutsche Texte (empfohlen)
MODEL_NAME=mistral         # Gute Balance zwischen Geschwindigkeit und Qualität
MODEL_NAME=llama3          # Leistungsstarkes Allround-Modell

Hinweis: Stellen Sie sicher, dass das gewählte Modell mit ollama pull <model-name> heruntergeladen wurde.

🛠️ Manuelle Ausführung

Falls Sie den Agent direkt über die Kommandozeile starten möchten:

# Mit Standardparametern
npx tsx serper_agent.ts "KI Nachhaltigkeit" 3

# Mit eigenen Parametern
npx tsx serper_agent.ts "Ihre Suchanfrage" 5

Parameter:

  • Argument 1: Suchanfrage (String)
  • Argument 2: Anzahl der Ergebnisse (Zahl)

📂 Projektstruktur

search-agent-bee-framework/
├── serper_agent.ts     # Hauptskript des Recherche-Agents
├── start_agent.bat     # Windows Batch-Datei zum einfachen Starten
├── .env               # Environment-Variablen (API-Keys)
├── README.md          # Diese Dokumentation
└── responses/         # Ordner für Suchergebnisse (wird automatisch erstellt)
    ├── recherche_report_YYYY-MM-DDTHH-MM-SS-SSSZ.json  # Vollständiger Recherche-Report
    └── gefundene_urls_YYYY-MM-DDTHH-MM-SS-SSSZ.json    # Liste der gefundenen URLs

Beispiel der generierten Dateien:

  • recherche_report_2025-06-30T12-56-40-566Z.json - Enthält Suchergebnisse, Analyse und Metadaten
  • gefundene_urls_2025-06-30T12-56-40-566Z.json - Enthält nur die URLs der gefundenen Quellen

🔍 Funktionsweise

  1. Websuche: Der Agent nutzt die Serper API für echte Google-Suchergebnisse
  2. KI-Analyse: Das LLM (llama3.2) über Ollama analysiert und strukturiert die gefundenen Informationen
  3. Zusammenfassung: Erstellt eine professionelle deutsche Zusammenfassung der Recherche-Ergebnisse
  4. Speicherung: Alle Ergebnisse werden im responses/ Ordner gespeichert

Der Agent orchestriert verschiedene Tools:

  • Serper API → Echte Google-Suche
  • Ollama → LLM-Hosting (llama3.2)
  • LLM → Textanalyse und Zusammenfassung
  • File System → Datenpeicherung

⚠️ Fehlerbehebung

Häufige Probleme und Lösungen

"npx tsx nicht gefunden"

npm install -g tsx

"dotenv nicht gefunden"

npm install dotenv

"Ollama Verbindungsfehler"

  1. Stellen Sie sicher, dass Ollama läuft:

    ollama serve

  2. Prüfen Sie, ob das Modell verfügbar ist:

    ollama list

"Serper API Fehler"

  1. Prüfen Sie Ihren API-Key in der .env Datei
  2. Stellen Sie sicher, dass Sie noch API-Guthaben haben
  3. Prüfen Sie Ihre Internetverbindung

"Keine Ergebnisse gefunden"

  • Prüfen Sie Ihre Suchanfrage auf Tippfehler
  • Versuchen Sie andere Suchbegriffe
  • Stellen Sie sicher, dass Ihr Serper API-Key gültig ist

🔒 Sicherheit

  • Niemals Ihren API-Key in öffentlichen Repositories teilen
  • Die .env Datei sollte nicht in Git committed werden
  • Überwachen Sie Ihre API-Nutzung regelmäßig

📖 Verwendungsbeispiele

Beispiel 1: Technologie-Recherche

Suchanfrage: "Künstliche Intelligenz 2024 Trends"
Ergebnisse: 5

Beispiel 2: Wissenschaftliche Forschung

Suchanfrage: "Klimawandel aktuelle Studien"
Ergebnisse: 3

Beispiel 3: Marktanalyse

Suchanfrage: "Elektroauto Markt Deutschland"
Ergebnisse: 4

✅ Funktionsstatus

Vollständig funktionsfähig:

  • ✅ Echte Google-Suche über Serper API
  • ✅ LLM-basierte Analyse mit Ollama (llama3.2)
  • ✅ Professionelle deutsche Zusammenfassungen
  • ✅ Strukturierte JSON-Ausgabe
  • ✅ Automatische Datenspeicherung
  • ✅ Saubere, übersichtliche Konsolen-Ausgabe

Architektur:

  • Agent-Code: TypeScript (serper_agent.ts) - orchestriert alle Tools
  • LLM: llama3.2 über Ollama - reine Textverarbeitung, keine Tools
  • Web-API: Serper (Google Search) - Datenquelle
  • Storage: Lokales File System - Ergebnisspeicherung