Introduction #
The AI Agents Explorer is the administration interface used to monitor AI agent activity in Kafinea. It provides a consolidated view of runs, usage statistics, and associated costs.
This page is reserved for administrators and restricted administrators.
1. Access #
Access the explorer via Settings > Extensions > AI Agents Explorer.
2. Statistics dashboard #
The top of the page displays a summary dashboard with:
- Total number of runs: number of AI agent executions
- Estimated cost: total estimated cost based on tokens consumed
- Tokens used: breakdown between prompt tokens (input) and completion tokens (output)
- Statistics by period: monthly or weekly breakdown
3. Run list #
The paginated list displays each AI agent run with the following information:
| Column | Description |
|---|---|
| Run ID | Unique identifier of the run |
| Agent | Name of the agent that performed the run |
| Model | AI model used (e.g., gpt-4, claude-3, etc.) |
| User | The Kafinea user who triggered the run |
| Status | Run state: running, completed, failed |
| Tokens | Number of prompt / completion / total tokens |
| Cost | Estimated cost of the run |
| Duration | Execution time |
| Date | Start date and time |
4. Filters #
You can filter the run list by:
- Status: running, completed, failed
- Agent: agent name
- Model: AI model used
- User: user who triggered the run
5. Run details #
By clicking a run, you can access the details, which include:
- Input summary (prompt sent)
- Event list (agent intermediate steps)
- Generated response
- Detailed metrics (tokens, cost, duration)
6. Tools available to agents #
AI agents have a set of tools that allow them to interact with Kafinea data:
- Search: search for records in modules
- Read: view the details of a record
- Browse: navigate relationships between records
- Analyze: calculate aggregates or statistics
- Create: create new records (requires the Beta toggle)
- Edit: update existing records (requires the Beta toggle)
- Delete: delete records (requires the Beta toggle)
Note: Agents follow the access rights of the user who triggers the run. The create, edit, and delete tools are only available if the (Beta) Allow the AI Agent to modify data option is enabled in Settings > Features.
7. Configuration #
AI agent configuration is managed in Kafinea configuration files:
- API key: configured in the AI gateway settings
- Feature flags: enable/disable AI features
- Available models: list of usable AI models
Important: Changing these settings requires server access.
FAQ #
How can I see how much AI usage costs?
The explorer dashboard displays the estimated cost per run and the total cost. These estimates are based on the number of tokens consumed.
Can an agent modify data?
Workflow-type agents (VTMdsPromptAITask) can update the fields configured in the mapping. AI chat can create, edit, and delete records only if the (Beta) Allow the AI Agent to modify data option is enabled in Settings > Features. When this option is disabled, AI chat runs in read-only mode.