AWS Strands

# 1. Install
cd examples/strands_agents
uv pip install -e .

# 2. Configure
cp .env.example .env
# Edit .env: Add OPENAI_API_KEY and AGENT_CONTROL_URL

# 3. Start server (Terminal 1)
curl -fsSL https://raw.githubusercontent.com/agentcontrol/agent-control/docker-compose.yml | docker compose -f - up -d

# 4. Setup controls (Terminal 2)
cd examples/strands_agents/interactive_demo
uv run setup_interactive_controls.py

# 5. Run demo (Terminal 3)
streamlit run interactive_support_demo.py

from agent_control.integrations.strands import AgentControlHook
from strands import Agent

import agent_control
agent_control.init(agent_name="my-customer-agent")

hook = AgentControlHook(agent_name="my-customer-agent")

agent = Agent(
    model=model,
    system_prompt="...",
    tools=[...],
    hooks=[hook]
)

{
    "scope": {"step_types": ["llm"], "stages": ["pre"]},
    "condition": {
        "selector": {"path": "input"},
        "evaluator": {"name": "regex", "config": {"pattern": r"\d{3}-\d{2}-\d{4}"}},
    },
    "action": {"decision": "deny"}
}

{
    "scope": {
        "step_types": ["tool"],
        "step_names": ["lookup_order"],
        "stages": ["pre"]
    },
    "condition": {
        "selector": {"path": "input"},
        "evaluator": {"name": "regex", "config": {"pattern": r"ORD-\d+"}},
    },
    "action": {"decision": "deny"}
}

User Input
  ↓
Strands fires event (BeforeToolCallEvent, AfterModelCallEvent, etc.)
  ↓
AgentControlHook intercepts → Creates Step → Calls AgentControl server
  ↓
Server evaluates controls → Returns safe or unsafe
  ↓
Hook enforces decision: Continue or Block

hook = AgentControlHook(
    agent_name="my-customer-agent",
    enable_logging=True
)