> For the complete documentation index, see [llms.txt](https://docs.riff.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.riff.ai/reference/agent-builder/activity.md). # Activity The Activity tab is the observability surface for your agent. It shows a timeline of every execution — when the agent ran, what triggered it, which tools it called, how long each step took, and whether it succeeded or failed. ## Two views Toggle between **Activity** (default) and **Logs** using the control at the top of the tab. ## Activity view Scrollable list of agent runs, newest first. Each entry (collapsed) shows: * **Status dot** — green for success, red for error * **"Agent run"** label * **Tool count badge** — e.g. "3 tools" * **Duration** — e.g. "234ms" * **Relative timestamp** — e.g. "2 hours ago" Click any entry to expand it and see: * **Message excerpt** — the prompt or trigger that started this run (shown in quotes) * **Turn count** — how many reasoning cycles the agent took * **Tool calls list** — for each tool: status dot · tool name · duration · input parameters preview Multiple sessions are separated by a horizontal rule showing the session ID. ## Logs view Raw console output for deeper technical debugging. Switch back to Activity using the toggle. ## When to use Activity * **Troubleshooting** — a run failed; expand it to see which tool call errored and what the inputs were * **Performance** — check how long each step is taking and whether any tool is a bottleneck * **Verification** — confirm that scheduled triggers are firing and completing successfully * **Audit** — see the full history of what the agent did and when ## Empty and error states * **No activity yet** — the agent has never run (check that triggers are configured in the [Triggers](/reference/agent-builder/triggers.md) tab) * **Could not load activity log** — a loading error; refresh the tab --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.riff.ai/reference/agent-builder/activity.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.