KI-Governance für CrewAI — Task-Guardrails, Step-Callbacks und Audit-Trails für jede Crew-Ausführung.

CrewAI Integration

Palveron integriert sich nativ in CrewAIs Guardrail-System. Jeder Task-Output wird gegen Ihre Governance-Policies geprüft, bevor er an den nächsten Task weitergegeben wird. Blockierte Outputs lösen automatische Retries mit Feedback aus.

Installation

pip install palveron-crewai

Schnellstart: Task Guardrail

from crewai import Agent, Task, Crew
from palveron_crewai import palveron_guardrail

guardrail = palveron_guardrail(api_key="pv_live_xxx")

bericht_task = Task(
    description="Erstelle einen Kundenanalyse-Bericht",
    expected_output="Ein Bericht mit Kundeneinblicken",
    agent=analyst_agent,
    guardrail=guardrail,           # Palveron Governance
    guardrail_max_retries=2,       # Retry bei Blockierung
)

Enthält der Output des Agenten PII oder verletzt er Ihre Policies, startet CrewAI automatisch einen Retry mit Palveron-Feedback.

Step Callback (Crew-weit)

Für Governance über alle Agent-Steps, nicht nur einzelne Tasks:

from palveron_crewai import PalveronStepCallback

callback = PalveronStepCallback(api_key="pv_live_xxx")

crew = Crew(
    agents=[researcher, writer],
    tasks=[research_task, write_task],
    step_callback=callback,
)

result = crew.kickoff(inputs={"topic": "KI-Sicherheit"})
print(f"Geprüft: {callback.check_count}, Blockiert: {callback.blocked_count}")

Kombinierte Governance

Convenience-Klasse für beide Patterns zusammen:

from palveron_crewai import PalveronCrewGovernance

gov = PalveronCrewGovernance(api_key="pv_live_xxx")

sensitiver_task = Task(..., guardrail=gov.task_guardrail())
crew = Crew(..., step_callback=gov.step_callback())

result = crew.kickoff(inputs={...})
print(gov.summary())  # {"checks": 12, "blocked": 1, "trace_ids": [...]}

Entscheidungsverhalten

Entscheidung	Guardrail gibt zurück	Effekt
`ALLOWED`	`(True, output)`	Task läuft normal weiter
`MODIFIED`	`(True, bereinigt)`	Weiter mit maskierten PII
`BLOCKED`	`(False, feedback)`	CrewAI startet Retry mit Feedback

Konfiguration

guardrail = palveron_guardrail(
    api_key="pv_live_xxx",
    base_url="https://gateway.intern.firma.de:8080",
    fail_open=False,
    metadata={"abteilung": "finanzen"},
)

Source Code

Open Source (MIT): github.com/palveron/adapter-crewai.

Nächste Schritte

Eigene Policies erstellen für Ihre Crew-Workflows
LangChain Integration für LLM-Level-Governance
OpenClaw Integration für persönliche KI-Agenten

CrewAI

On this page