Getting Started with CrewAI
OpenBox integrates with CrewAI by wrapping crew execution with a governed engine and replacing governed agents and tasks with OpenBox-aware subclasses. Your crew structure stays recognizable while OpenBox adds approvals, guardrails, telemetry, and audit-grade evidence.
One Bootstrap Change
- CrewAI
- OpenBox
crew.py
from crewai import Agent, Crew, Process, Task
researcher = Agent(role="Researcher", goal="Find information")
task = Task(
description="Research AI governance patterns.",
expected_output="A short summary.",
agent=researcher,
)
crew = Crew(
agents=[researcher],
tasks=[task],
process=Process.sequential,
)
result = crew.kickoff()
crew.py
from crewai import Crew, Process
from openbox import OpenBoxAgent, OpenBoxTask, create_openbox_engine
researcher = OpenBoxAgent(
role="Researcher",
goal="Find information",
env_prefix="OPENBOX_RESEARCHER",
)
task = OpenBoxTask(
description="Research AI governance patterns.",
expected_output="A short summary.",
agent=researcher,
activity_type="research",
)
crew = Crew(
agents=[researcher],
tasks=[task],
process=Process.sequential,
)
with create_openbox_engine() as engine:
result = engine.govern(crew).kickoff()
Choose Your Path
Run the Demo
Use the demos in the public SDK repository to see governed single-agent, async, flow, and collaborative CrewAI runs.
Wrap an Existing Crew
Add OpenBox to an existing CrewAI codebase by swapping in OpenBoxAgent, OpenBoxTask, and engine.govern(crew).
What OpenBox Captures
From a single integration point, OpenBox captures:
- task boundary events for governed tasks
- governed session lifecycle per agent
- approvals, blocks, halts, and guardrail outcomes
- HTTP and database telemetry by default
- file I/O telemetry when enabled
- flow correlation metadata for governed crews inside CrewAI flows
What To Expect In The UI
After integration, OpenBox gives you:
- a governed run timeline for each agent session
- policy and guardrail decisions at task boundaries
- telemetry attached to the governed crew execution
- session replay and audit context for multi-agent runs
- clearer attribution across delegated or hierarchical work
Next Steps
- Use Run the Demo if you want the fastest working path.
- Use Wrap an Existing Crew if you already have CrewAI in development or production.
- Continue to the CrewAI SDK (Python) guide set for configuration, approvals, telemetry, and troubleshooting.