> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/dastra-ai/ai-assistant/agents/autonomous.md).

# Créer un agent autonome

Configurez un agent qui s'exécute seul, manuellement, selon un planning ou depuis une règle de workflow

Un agent autonome exécute une tâche de bout en bout, sans personne devant l'écran : passer en revue un périmètre du registre, préparer un plan d'action, produire une synthèse mensuelle.

Rendez-vous dans **Automatisation** > **Dastra AI** > **Agents**, cliquez sur **Créer un agent**, puis sur **Agent autonome**.

{% hint style="warning" %}
**Un agent autonome ne peut pas vous poser de question.** Les outils qui demandent une interaction (poser une question, naviguer dans l'interface) lui sont retirés, et ses outils de modification s'exécutent sans demande de confirmation. Son instruction doit donc couvrir tous les cas, y compris ce qu'il doit faire quand une information manque.
{% endhint %}

***

### Configuration de l'agent

L'**instruction système** (10 000 caractères maximum) décrit la mission complète. Contrairement à un agent conversationnel, où vous définissez surtout une personnalité, il s'agit ici d'une procédure.

Une instruction système efficace est numérotée, explicite sur les limites, et précise le format du résultat attendu :

```
Vous réalisez la revue mensuelle du registre des traitements.

Étapes à suivre :
1. Listez les fiches de traitement de l'unité organisationnelle indiquée
   dans le champ de saisie.
2. Pour chaque fiche, vérifiez que la finalité, la base légale, la durée
   de conservation et les mesures de sécurité sont renseignées.
3. Regroupez les manques constatés par fiche.
4. Créez un plan d'action contenant une tâche par fiche incomplète, en
   précisant les champs à compléter.

Ne modifiez aucune fiche de traitement : limitez-vous à la création des
tâches du plan d'action.

Terminez par un résumé en français indiquant le nombre de fiches examinées,
le nombre de fiches incomplètes et les tâches créées.
```

***

### Champs de saisie

Les champs de saisie composent le court formulaire rempli avant une exécution. Chaque valeur parvient à l'agent **sous son nom technique** : utilisez donc ces noms dans l'instruction système pour lui indiquer quoi en faire.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-e9e9f6cefe4d25af43fea623cde3950fd267d9ab%2Fai-agents-editeur-autonome.png?alt=media" alt="Éditeur d&#x27;un agent autonome avec ses champs de saisie et l&#x27;aperçu du formulaire"><figcaption><p>Les champs de saisie et leur aperçu, à droite</p></figcaption></figure>

Chaque champ se définit par :

| Paramètre       | Rôle                                                      |
| --------------- | --------------------------------------------------------- |
| **Libellé**     | Ce que voit la personne qui lance l'exécution             |
| **Nom**         | Le nom technique sous lequel la valeur parvient à l'agent |
| **Type**        | Texte, Nombre, Booléen ou Liste de choix                  |
| **Obligatoire** | Empêche de lancer l'exécution tant que le champ est vide  |
| **Défaut**      | Valeur pré-remplie                                        |
| **Description** | Aide affichée sous le champ                               |

Un agent sans aucun champ de saisie s'exécute sans rien demander.

{% hint style="info" %}
Le **Nom** est pré-rempli automatiquement à partir du libellé. Si vous le modifiez, vérifiez la valeur finale : c'est elle que vous devez citer dans l'instruction système.
{% endhint %}

L'**aperçu du formulaire**, à droite de l'éditeur, montre exactement ce que verront vos utilisateurs. Il sert aussi à lancer une exécution de test.

***

### Outils

Le fonctionnement est proche de celui d'un [agent conversationnel](https://doc.dastra.eu/dastra-ai/ai-assistant/agents/conversational.md#outils) : par défaut tous les outils sont disponibles, et vous pouvez restreindre chaque groupe avec **Tout**, **Aucune** ou **Personnalisé**.

L'enjeu est cependant plus important ici, puisque personne ne relit l'agent pendant qu'il travaille. Accordez-lui les outils de lecture dont il a besoin, et **uniquement les outils de modification que sa mission exige**.

### Notifications

Choisissez les **Utilisateurs notifiés** de l'agent. Ils reçoivent une notification Dastra lorsqu'une exécution se termine, et une autre lorsqu'elle ne se termine pas. Une exécution qui se termine avec le statut **Revue humaine requise** est considérée comme terminée. Une exécution qui se termine avec un autre statut, comme **Échouée** ou **Informations manquantes**, est considérée comme non terminée.

***

### Planification

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-9cbd194b6230c1f285cdd4c7509293a954f0a060%2Fai-agents-planification.png?alt=media" alt="Bloc de planification d&#x27;un agent autonome, fréquence hebdomadaire"><figcaption><p>La planification d'un agent autonome</p></figcaption></figure>

Choisissez une **Fréquence** (**Pas de planification**, **Quotidien**, **Hebdomadaire** ou **Mensuel**) puis l'**Heure**, et selon le cas le **Jour de la semaine** ou le **Jour du mois**.

{% hint style="info" %}
**Les heures sont affichées dans votre fuseau horaire**, comme l'indique la mention sous le formulaire. Dastra les enregistre en UTC : c'est pourquoi la vignette de l'agent dans la liste peut afficher une heure différente de celle que vous avez saisie.

Le déclencheur passe **une fois par heure, à l'heure pile**. Une planification ne peut donc pas viser une minute précise.
{% endhint %}

Seuls les agents **actifs**, non archivés et de type autonome sont pris en compte par la planification.

***

### Les trois façons de déclencher une exécution

#### 1. Manuellement

Remplissez le formulaire dans l'aperçu, puis cliquez sur **Exécuter**. L'exécution est mise en file d'attente : vous êtes redirigé vers la boîte de réception, où vous la voyez passer de **En cours** à son statut final. Un agent désactivé peut être exécuté ainsi, ce qui permet de le tester avant de l'activer.

#### 2. Selon le planning

L'agent part tout seul à la fréquence configurée. Une exécution planifiée ne reçoit aucune valeur pour ses champs de saisie : la valeur **Défaut** ne sert qu'à préremplir le formulaire d'une exécution manuelle. Rédigez l'instruction système de sorte que l'agent ne dépende pas d'un champ de saisie lorsqu'il s'exécute selon un planning.

#### 3. Depuis une règle de workflow

Dans **Automatisation** > **Règles de workflow**, l'action **Exécuter un agent IA** permet de déclencher un agent à partir d'un événement sur une fiche (changement d'étape, création, échéance). Voir [Règles de workflow](https://doc.dastra.eu/features/settings/workflow-rules.md).

Vous y choisissez l'**Agent IA à exécuter**, un **Message d'instruction** facultatif (2000 caractères au plus) et les valeurs des **Champs d'entrée de l'agent**. Le message et les valeurs acceptent des **variables personnalisées** résolues depuis la fiche qui a déclenché la règle : l'agent reçoit donc un contexte différent à chaque exécution. Un agent désactivé, ou placé dans la corbeille, n'est pas démarré.

***

### Limites d'une exécution

| Limite                              | Comportement                                                                                                                         |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **30 itérations d'outils** par tour | Au-delà, l'agent doit conclure : l'exécution se termine en *Exécution incomplète*                                                    |
| **Taille du contexte**              | Les échanges d'outils les plus anciens sont résumés ; en cas de dépassement, l'exécution se termine en *Limite de contexte atteinte* |
| **10 000 caractères** en entrée     | Un message plus long est refusé                                                                                                      |
| **Quota de crédits**                | Une exécution est refusée si le quota mensuel est atteint                                                                            |

Ces statuts, et les autres, sont détaillés dans [Suivre les exécutions](https://doc.dastra.eu/dastra-ai/ai-assistant/agents/inbox.md).

***

{% content-ref url="/pages/fQn5aJb2uTZpUTyVUVZU" %}
[Suivre les exécutions](https://doc.dastra.eu/dastra-ai/ai-assistant/agents/inbox.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/dastra-ai/ai-assistant/agents/autonomous.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
