Reports
Search2o keeps a record of every agent execution, including failures, for 7 days. The paid service has no such limit. The reports summarize those records. Developers see the agent reports; administrators also see the user usage reports.
Every report covers a time window that you choose and returns a table and a trend. The trend uses hourly buckets when the window is 48 hours or less, and daily buckets otherwise. A row in the table opens a detail report for that agent or user.
- Agent performanceOne row per agent: how often the agent ran, for how many users, how often it succeeded, and how long a run took.
- Agent errorsOne row per agent that failed at least once: how often the agent failed, for how many users, and with which result codes.
- LLM costOne row per agent: the total LLM spend, the average spend per execution, and the highest spend of any single execution. Every execution counts, whether or no…
- User usageOne row per user: executions, distinct agents used, success rate, LLM spend and last activity. Administrators only. The table is paged and can be sorted by a…
What is recorded
Each record holds the agent and its version, the user, the start time and the duration, the result code, the error message if there was one, and the LLM cost and LLM time. Validation runs of drafts are not recorded.
Result codes
| Code | Meaning |
|---|---|
success | The agent completed. Counted as a success. |
ask | The agent paused to ask the user for input. Counted as a success. |
callFailed | The agent server could not complete a call to Search2o Cloud during the run. |
failCommand | The agent ended itself with the fail command. |
errorInAgent | A coding error in the agent, or a run that passed the agent's LLM cost limit. |
unknownConversation | The conversation could not be found, is paused on an ask by a different agent, or the agent that asked has been republished since. |
timedOut | The run exceeded the agent's maximum run time. |
stopped | The user stopped the run. |
mustLogin | The session expired during the run. |
unexpected | An unknown exception was raised. |

