> For the complete documentation index, see [llms.txt](https://doc.cards-microlearning.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.cards-microlearning.com/english/ai-agents-and-mcp/ai-agents.md).

# AI Agents

### Agents list

<figure><img src="/files/ZTkmWM4AbSOoCVYct7lg" alt=""><figcaption><p>Agents list</p></figcaption></figure>

The list of AI agents is available on the "Apps and Integrations" page, then under "AI Agents and MCP Connectors." The tabs allow you to view the list of AI agents or MCP connectors.

In the AI ​​agent list, you will find two sections: one listing your agents (those you created) and the other listing agents created by other members of your team.

### What can an agent do?

An AI agent has access to a list of tools, allowing it to interact directly with the content of your Cards space. These tools are the same as those used for MCP connectors.

The tools are as follows:

* Trainings Tool: allows access to, creation of, and editing of training courses
* Chapters Tool: access, creation of, modification, and deletion of chapters
* Cards Tool: access, creation, modification, and deletion of content cards
* Categories Tool: access, creation, and editing of training categories
* Routines Tool: access, creation, and editing of routines (and listing of routine categories)
* Steps Tool: access, creation, editing, and deletion of routine steps
* Giphy Search Tool: search for GIFs on Giphy
* Unsplash Search Tool: search for images on Unsplash
* YouTube Search Tool: search for videos on YouTube
* Image Upload Tool: upload an image to your media library from a URL.

For more granular permission control, you can create a custom role specific to your AI agent. This permission control applies to the Cards side, so no agent can override it.

For more information, see the "[Custom Roles](/english/my-space/custom-roles.md)" documentation.

### Create an agent

<figure><img src="/files/BAexpW7e3sj48qeFEH3J" alt=""><figcaption><p>Creation and editing of an AI agent</p></figcaption></figure>

When you create an AI agent, you give it a first name, a last name, and a role.

The content created by this agent will then be easily identifiable in your content listings (the "author" column will display the agent's first and last name).

The role you choose must be a custom role. For more information, see the "[Custom Roles](/english/my-space/custom-roles.md)" documentation. By assigning it a custom role, you can limit its actions on your content (for example, to only allow it to edit its own courses, and not those of other editors).

Several configuration settings are available in the right-hand column:

* Agent Type: allows you to choose the agent's behavior
* Custom Instructions: allows you to "prompt" the agent by giving it instructions that will be applied when you call upon it
* Availability:
  * Private: only you can use the agent
  * Public: the agent can be used by other editors in your space.

### Use an agent

<figure><img src="/files/0ZsV5JZQyu5EioqlYRVT" alt=""><figcaption><p>Use of an agent</p></figcaption></figure>

To use an AI agent, click on the "AI" bubble in the bottom right corner. A panel will open on the side, allowing you to select the agent you want to use.

Once you've selected an agent, a chat window will appear, and you can chat directly with the AI ​​agent. In this chat, in the top right corner, you can view your previous conversations and pick up where you left off.

The agent knows your first and last name, which allows it to know what content you've created. However, it currently cannot "see" which page you are on: you must therefore specify the name of the training course or its ID if you want the agent to interact with it.


---

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

```
GET https://doc.cards-microlearning.com/english/ai-agents-and-mcp/ai-agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.