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

# Créer un agent

> Guide étape par étape pour créer votre premier agent IA

## Tableau de bord

<Steps>
  <Step title="Accédez à Agents">
    Dans la barre latérale, cliquez sur **Agents**.
  </Step>

  <Step title="Cliquez sur Create Agent">
    Donnez à votre agent un nom descriptif tel que « Sales Assistant » ou « Support Bot ».
  </Step>

  <Step title="Choisissez les fournisseurs">
    Sélectionnez vos fournisseurs LLM, TTS et STT préférés. En cas de doute, les valeurs par défaut fonctionnent bien :

    * **LLM** : OpenAI GPT-4o-mini
    * **TTS** : ElevenLabs
    * **STT** : Deepgram
  </Step>

  <Step title="Rédigez un system prompt">
    Il définit la personnalité et le comportement de votre agent. Consultez le [guide du system prompt](/fr/agents/system-prompt) pour des conseils.
  </Step>

  <Step title="Définissez un premier message">
    La salutation que votre agent prononce dès la connexion d'un appel. Elle est envoyée directement au TTS (sans passer par le LLM) pour une réponse plus rapide.
  </Step>

  <Step title="Testez">
    Cliquez sur **Talk to Agent** pour démarrer un appel WebRTC dans votre navigateur et tester la conversation.
  </Step>
</Steps>

## API

```bash theme={null}
curl -X POST https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Assistant",
    "llm_provider": "openai",
    "llm_model": "gpt-4o-mini",
    "tts_provider": "elevenlabs",
    "tts_voice_id": "YOUR_VOICE_ID",
    "stt_provider": "deepgram",
    "system_prompt": "You are a helpful sales assistant for Acme Corp...",
    "first_message": "Hi! Thanks for reaching out. How can I help you today?",
    "recording_enabled": true
  }'
```

## Champs de l'agent

| Champ               | Type    | Description                                                   |
| ------------------- | ------- | ------------------------------------------------------------- |
| `name`              | string  | Nom d'affichage de l'agent                                    |
| `llm_provider`      | string  | Fournisseur LLM : `openai`, `claude`, `azure`                 |
| `llm_model`         | string  | Nom du modèle : `gpt-4o-mini`, `claude-3-5-sonnet`, etc.      |
| `tts_provider`      | string  | Fournisseur TTS : `elevenlabs`, `cartesia`, `azure`           |
| `tts_voice_id`      | string  | ID de voix de votre fournisseur TTS                           |
| `stt_provider`      | string  | Fournisseur STT : `deepgram`, `azure`, `elevenlabs`, `openai` |
| `system_prompt`     | string  | Instructions et personnalité de l'agent                       |
| `first_message`     | string  | Salutation prononcée lors de la connexion de l'appel          |
| `recording_enabled` | boolean | Faut-il enregistrer les appels                                |
| `ambience_enabled`  | boolean | Faut-il diffuser une ambiance sonore en arrière-plan          |

## Ajouter des outils à votre agent

Donnez à votre agent la capacité d'agir pendant les conversations :

<Steps>
  <Step title="Configurez une intégration">
    Accédez à **Settings → Integrations** et connectez un service (HubSpot, Salesforce, Slack, etc.).
  </Step>

  <Step title="Créez un outil">
    Accédez à **Tools → Create Tool** et sélectionnez un modèle correspondant à votre intégration.
  </Step>

  <Step title="Affectez-le à votre agent">
    Dans l'onglet **Tools** de votre agent, ajoutez l'outil. L'agent peut désormais l'utiliser pendant les conversations.
  </Step>
</Steps>

## Activer le mode vidéo

Donnez à votre agent une présence visuelle grâce à un avatar vidéo :

<Steps>
  <Step title="Accédez à l'onglet Video">
    Dans les paramètres de votre agent, cliquez sur l'onglet **Video**.
  </Step>

  <Step title="Choisissez un avatar">
    Parcourez la bibliothèque d'avatars et choisissez celui qui correspond à votre marque.
  </Step>

  <Step title="Activez la vidéo">
    Activez le mode vidéo. Votre agent apparaîtra désormais sous forme d'avatar vidéo lors des appels vidéo.
  </Step>
</Steps>