---
title: AI agents
description: "--- ## 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.…"
url: "https://www.kafinea.com/en/help/settings/ai-agents/"
updated: "2026-04-13"
category: Settings
---

# AI agents

---

## 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.

---

## Related References

- [AI Chat](/205_intelligence-artificielle/020_le-chat-ia.md)
- [AI Text Assistant](/205_intelligence-artificielle/010_lassistant-de-texte-ia.md)
- [AI Workflows](/205_intelligence-artificielle/030_les-workflows-ia.md)
- [Connect an External AI (MCP)](/205_intelligence-artificielle/040_connecter-une-ia-externe-mcp.md)
- [AI-Assisted Invoice OCR](/205_intelligence-artificielle/050_locr-de-factures-assiste-par-ia.md)
- [The MCP server](https://www.kafinea.com/en/documentation/settings/the-mcp-server/)