Execution History
Every action an AI agent takes in BFF is logged and visible in the management UI. This provides full transparency into what your AI team members are doing.
Viewing Execution Logs
- Navigate to AI Agents
- Open the agent’s detail view
- Go to the Execution History tab
- See a chronological list of all executions
What’s in the Logs
Each execution log entry contains:
| Field | Description |
|---|---|
| Task Name | Which task was being executed |
| Start Time | When execution began |
| End Time | When execution completed |
| Status | Success, failed, or in-progress |
| Steps Completed | Progress through the Work Instruction steps |
| Step Details | What happened at each step |
| Errors | Any failures or issues encountered |
Step-by-Step Progress
For tasks with structured Work Instructions, the execution log shows per-step detail:
- Step 1: Pull data — ✅ Completed (2.3s)
- Step 2: Transform data — ✅ Completed (1.1s)
- Step 3: Generate report — ✅ Completed (4.7s)
- Step 4: Send to client — ❌ Failed (API timeout)
Filtering and Searching
- Filter by date range — see executions from a specific period
- Filter by status — show only failures or successes
- Filter by task — see executions for a specific task
Using Logs for Troubleshooting
When an agent task fails:
- Open the execution log for the failed run
- Find the step that failed
- Review the error details
- Check if the Work Instruction needs updating
- Fix the issue and re-run
Tip: Regular log review helps you optimize AI agent performance. Look for steps that consistently take longer than expected — they may need better instructions or different tooling.