Introduction #
The AI Agent Explorer is the administrative interface used to monitor the activity of AI agents in Kafinea. It provides a consolidated view of runs, usage statistics, and associated costs.
This page is restricted to administrators and limited administrators.
1. Access #
Access the Explorer via Settings > Extensions > AI Agents Explorer.
2. Statistics Dashboard #
The top of the page displays a summary dashboard that includes:
- Total number of runs: number of times AI agents were executed
- Estimated cost: total estimated cost based on the tokens consumed
- Tokens used: breakdown between prompt tokens (input) and completion tokens (output)
- Statistics by period: monthly or weekly breakdown
3. List of executions #
The paginated list displays each AI agent run along with the following information:
| Column | Description |
|---|---|
| Run ID | Unique execution ID |
| Agent | Name of the officer who carried out the execution |
| Model | AI model used (e.g., GPT-4, Claude-3, etc.) |
| User | The Kafinea user who initiated the execution |
| Status | Execution status: running, completed, failed |
| Tokens | Number of prompt tokens / completion tokens / total tokens |
| Cost | Estimated cost of implementation |
| Duration | Runtime |
| Date | Launch date and time |
4. Filters #
You can filter the list of runs by:
- Status: in progress, completed, failed
- Agent: Agent's name
- Model: AI model used
- User: the user who initiated the execution
5. Detail of an execution #
When you click on a run, you'll see the details, which include:
- Summary of the entry (prompt sent)
- The list of events (intermediate steps of the agent)
- The 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 the modules
- Reading: View the details of a record
- Navigation: Browse relationships between records
- Analysis: Calculating 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 adhere to the access rights of the user who initiates the action. The tools for creating, editing, and deleting are only available if the (Beta) "Allow AI Agent to modify data " option is enabled in Settings > Features.
7. Configuration #
The configuration of AI agents is managed in Kafinea's configuration files:
- API key: configured in the AI gateway settings
- Feature flags: enabling/disabling AI features
- Available models: list of AI models that can be used
Important: Changing these settings requires access to the server.
FAQ #
How can I see how much it costs to use AI?
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 agents (VTMdsPromptAITask) can update the fields configured in the mapping. The AI chat can create, edit, and delete records only if the (Beta) Allow AI Agent to Modify Data option is enabled in Settings > Features. When this option is disabled, the AI chat operates in read-only mode.