> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shortext.ny-corp.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer un agent

> Créez un agent, rédigez ses instructions, rattachez-le à des canaux et restez dans la limite d'agents de votre forfait.

Un agent répond à vos clients sur les canaux qui lui sont rattachés. Vous pouvez créer des agents depuis le tableau de bord ou par l'API (`POST /agents`, voir la [Référence API](https://docs.shortext.ny-corp.io/fr/api-reference/introduction.md)).

## Créer l'agent

**1. Ouvrez les agents**

Dans la barre latérale, ouvrez **Communication > Agents IA** et créez un nouvel agent.

**2. Nommez-le et choisissez sa façon de répondre**

* **Nom** : affiché à votre équipe dans la boîte de réception, les statistiques et l'API.
* **Agent enabled** (agent activé) : un agent désactivé continue d'enregistrer les messages mais ne répond pas.
* **Use AI** (utiliser l'IA) : l'IA répond en suivant les instructions. Quand elle est désactivée, l'agent envoie à la place le **message d'indisponibilité**, par exemple « Notre équipe vous répondra pendant nos heures d'ouverture. »

**3. Rédigez les instructions**

Les instructions sont le prompt système de l'IA (jusqu'à 15 000 caractères). Décrivez qui est l'agent, ce à quoi il peut répondre, le ton à adopter et quand il doit passer la main à une personne. Par exemple :

```text theme={null}
Tu es l'assistant support d'Acme, une boutique en ligne.
Réponds dans la langue du client, en messages courts.
Tu peux suivre les commandes avec l'outil get_order. Ne promets jamais de remboursement :
quand un client en demande un, dis-lui qu'une personne de l'équipe va le recontacter.
```

Vous pouvez modifier les instructions à tout moment ; les conversations en cours gardent leur historique.

**4. Donnez-lui des outils et des connaissances (facultatif)**

* Les **outils** permettent à l'agent d'appeler vos propres API, par exemple pour consulter une commande. Voir [Outils](https://docs.shortext.ny-corp.io/fr/agents/tools-configuration.md).
* Les **bases de connaissances** sont des documents dans lesquels l'agent cherche avant de répondre : FAQ, conditions, fiches produits.

**5. Rattachez des canaux**

Un agent ne répond que sur les canaux qui lui sont rattachés. Connectez un canal et choisissez cet agent, ou déplacez-y un canal existant. Voir [Canaux](https://docs.shortext.ny-corp.io/fr/channels/overview.md).

## Tester avant la mise en production

Avant de rattacher un canal de production, testez l'agent sur un numéro ou une boîte mail de test : écrivez-lui comme le ferait un client, vérifiez les réponses et les appels d'outils dans les journaux, et affinez les instructions.

## Limite d'agents de votre forfait

Votre forfait fixe le nombre d'agents que votre entreprise peut avoir. Une fois la limite atteinte, la création d'un agent (ou la restauration d'un agent supprimé) est refusée, dans le tableau de bord comme dans l'API, où la réponse a le `code` `1005` et où `body.limit` donne la limite de votre forfait.

Pour libérer une place, supprimez un agent que vous n'utilisez plus. Pour avoir plus d'agents, changez de forfait depuis **Facturation**.

## Désactiver ou supprimer un agent

* **Désactivez-le** (décochez **Agent enabled**) pour qu'il cesse de répondre tout en gardant ses canaux.
* **Supprimez-le** quand vous n'en avez plus besoin. Un agent qui a encore des canaux ne peut pas être supprimé : déplacez ou détachez d'abord ses canaux. Ses tickets, ses outils et son historique sont conservés, et un agent supprimé peut être restauré tant que votre forfait le permet.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.