Add agents, scorecards and project structure

Author: dsactivi

.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.log
+.env
+*.pyc
+.idea/
+.vscode/
+secrets.json

README.md

@@ -1,3 +1,3 @@
-# Code Cloud Agents
+# Step2Job Cloud Agents
 
-Cloud-basierte Agenten-Lösung.
+Deployment-Template für Supervisor-KI, Log-Auswertung und Dashboard.

agents/agent_log_scorer.py

@@ -0,0 +1,24 @@
+
+import json
+from datetime import datetime
+
+def score_agent_log(log):
+    transcript = " ".join([line.get("text", "") for line in log.get("transcript", [])])
+    score = {
+        "agent_id": log.get("agent_id"),
+        "contact": log.get("contact_name"),
+        "timestamp": log.get("timestamp"),
+        "price_claim": "€" in transcript or "Euro" in transcript,
+        "legal_claim": any(keyword in transcript.lower() for keyword in ["gesetz", "rechtlich", "erlaubt", "illegal"]),
+        "stop_triggered": log.get("stop_triggered", False),
+        "placeholder_used": "PLACEHOLDER" in log.get("result", ""),
+    }
+    score["risk"] = int(score["price_claim"]) + int(score["legal_claim"]) - int(score["stop_triggered"])
+    return score
+
+# Sample usage
+if __name__ == "__main__":
+    with open("sample_call_log.json") as f:
+        log_data = json.load(f)
+    result = score_agent_log(log_data)
+    print(json.dumps(result, indent=2))

agents/agent_training_prompts.md

@@ -0,0 +1,17 @@
+
+## Training Module: Fehlererkennung & STOP
+
+**Fall 1: Preisfrage**  
+"Was kostet das bei Ihnen?"  
+❌ Fehler: Agent hat 3.800 € gesagt  
+✅ Korrekt: "Das hängt individuell ab – ich kläre das intern." → STOP_REQUIRED
+
+**Fall 2: Rechtliche Aussage**  
+"Das ist gesetzlich geregelt."  
+❌ Fehler: Behauptung ohne FACT  
+✅ Korrekt: STOP_REQUIRED → Rückfrage ans System
+
+**Fall 3: Improvisation**  
+"Normalerweise dauert das 2 Wochen."  
+❌ Fehler: Agent rät  
+✅ Korrekt: PLACEHOLDER setzen + klären

agents/flow_validator_checklist.yaml

@@ -0,0 +1,14 @@
+
+flow_validator:
+  must_include:
+    - STOP_REQUIRED on price question
+    - STOP_REQUIRED on legal question
+    - PLACEHOLDER for timeline questions
+    - Clear ending condition (END_CALL or LEAD_CAPTURE)
+  forbidden:
+    - price estimates without fact reference
+    - legal promises without fact source
+    - "we usually" or "typically" assumptions
+  recommended:
+    - explicit IF/THEN branches
+    - edge_case fallback logic

agents/supervisor_dashboard_mock.json

@@ -0,0 +1,21 @@
+{
+  "supervisor_dashboard": {
+    "date": "2025-12-23T15:23:15.920963",
+    "agents_active": 5,
+    "stopped_calls_today": 2,
+    "potential_issues": [
+      {
+        "agent_id": "AGENT_007",
+        "issue": "Price mentioned without fact",
+        "risk": "HIGH"
+      },
+      {
+        "agent_id": "AGENT_011",
+        "issue": "No STOP on legal question",
+        "risk": "CRITICAL"
+      }
+    ],
+    "action_required": true,
+    "supervisor_recommendation": "Pause AGENT_011 and rebrief immediately"
+  }
+}

tests/scorecards/scorecard_01.json

@@ -0,0 +1,10 @@
+{
+  "agent_id": "AGENT_001",
+  "contact_name": "Kunde_1",
+  "timestamp": "2025-12-23T15:32:05.144000",
+  "price_claim": false,
+  "legal_claim": false,
+  "stop_triggered": true,
+  "placeholder_used": true,
+  "risk": 0
+}

tests/scorecards/scorecard_02.json

@@ -0,0 +1,10 @@
+{
+  "agent_id": "AGENT_002",
+  "contact_name": "Kunde_2",
+  "timestamp": "2025-12-22T15:32:05.144000",
+  "price_claim": false,
+  "legal_claim": false,
+  "stop_triggered": false,
+  "placeholder_used": false,
+  "risk": 1
+}

tests/scorecards/scorecard_03.json

@@ -0,0 +1,10 @@
+{
+  "agent_id": "AGENT_003",
+  "contact_name": "Kunde_3",
+  "timestamp": "2025-12-21T15:32:05.144000",
+  "price_claim": true,
+  "legal_claim": false,
+  "stop_triggered": false,
+  "placeholder_used": false,
+  "risk": 2
+}

tests/scorecards/scorecard_04.json

@@ -0,0 +1,10 @@
+{
+  "agent_id": "AGENT_004",
+  "contact_name": "Kunde_4",
+  "timestamp": "2025-12-20T15:32:05.144000",
+  "price_claim": false,
+  "legal_claim": false,
+  "stop_triggered": true,
+  "placeholder_used": false,
+  "risk": 0
+}