Skip to main content

Testing Actors

CleverThis provides two ways to test an Actor before pointing production traffic at it: the built-in Chat interface for interactive testing, and the API for automated testing in CI pipelines.

Interactive testing with Chat​

The Chat page in the sidebar is the fastest way to interactively test an Actor. It behaves like any chat client, but you can switch the model to any Actor endpoint deployed in your workspace.

  1. Navigate to Chat.
  2. Click the model selector (usually labeled with the current model name near the top of the chat panel).
  3. Find your Actor in the list — it will be shown under its namespace deployment slug.
  4. Type a message and press Enter.

The chat panel shows the full response including streaming output. For multi-step Actors, you can enable Debug mode (the bug icon in the toolbar) to see intermediate steps: which agents ran, what each returned, and how long each step took.

Trace view​

Debug mode exposes the Actor execution trace for each message. The trace shows:

  • Agent execution order
  • The model ID each llm agent called
  • Token usage per step
  • Tool call inputs and outputs
  • Routing decisions made by router agents
  • Total wall-clock time

Testing via the API​

For automated testing, call your Actor endpoint exactly as you would any other model:

curl https://api.cleverthis.com/v1/chat/completions \
  -H "Authorization: Bearer ct_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "your-namespace/your-actor", "messages": [{"role": "user", "content": "test input"}]}'
Coming soon

A structured test harness for Actor assertion testing (expected output patterns, latency budgets) is on the roadmap.