CrewAI
problemen oplossen
Troubleshooting voor CrewAI multi-agent crews: start, installatie, Python dependencies, API’s, workflows, agent communicatie, webhooks en databases — logs eerst, herinstallatie later.
Start
CrewAI start niet
Controleer Python-omgeving, of de juiste venv actief is en of API-keys in .env staan. Vergelijk met een werkende installatie-baseline — herinstalleer niet vóór je logs hebt geëxporteerd.
Setup
Installatieproblemen
Veelvoorkomend: verkeerde Python-versie, ontbrekende packages, incomplete configuratie of pad-problemen. Doorloop vereisten op de installatiepagina en wijzig één variabele per keer.
Python
Python dependency problemen
Conflicten tussen crewai, langchain/tool-packages of pinned vs floating versions. Gebruik een schone venv, pip freeze vóór/na fix, en pin versies in requirements — zie Install.
API
API fouten
401/403: credentials of scopes. 429: rate limits op LLM of tools. 5xx: upstream of payload. Log statuscode, endpoint en correlation-id; details bij API Integrations.
workflows
Workflow fouten
Stuck crew-runs, timeouts of mislukte tasks. Isoleer één crew en één task, replay in staging. Basis: workflows.
Agents
Agent communicatie problemen
Onduidelijke handoffs tussen agents, ontbrekende context in delegated tasks of loops zonder exit. Documenteer rollen en verwachte outputs; vereenvoudig de crew tot het minimum dat werkt.
webhooks
Webhook fouten
Signature mismatch, dubbele delivery of payloads die de crew niet verwacht. Log event-type en body-hash (niet secrets); test met vast test-event.
Data
Database problemen
Connection pool uitgeput, firewall, verkeerde connection string of SSL-modus via database-tools. Test connectie buiten de crew; geen destructieve queries op productie tijdens debug.
observability
Logs en monitoring
Verzamel crew-run logs, tool-errors en task-traces vóór config-wijzigingen. Meet error rate en run-duur over tijd — niet alleen één failed run.
Support
Wanneer Ploko inschakelen?
Schakel Ploko in bij productie-incidenten, integratie-cutovers of als interne debug langer dan een werkdag duurt. CrewAI specialist · contact.
CrewAI cluster
Gerelateerde onderwerpen
Hub Install workflows safety API Integrations Specialist OpenClaw hub Hermes hub