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

# Créer une tâche d’agent (v1)

> Obsolète : utilisez plutôt [v2 create agent job](/api/agent/v2/create-agent-job). Crée une nouvelle tâche d’agent capable de générer et de modifier de la documentation à partir des messages fournis et des informations de branche.

Authentifiez-vous avec une clé d'API administrateur.

<Warning>Cet endpoint est obsolète. Utilisez plutôt l’endpoint [v2 create agent job](/docs/fr/api/agent/v2/create-agent-job).</Warning>

Cet endpoint crée une tâche d’agent à partir des messages fournis et des informations de branche. La tâche s’exécute de manière asynchrone et renvoie une réponse en streaming contenant les détails d’exécution et les résultats.

Si la branche n’existe pas, l’agent en crée une. Si l’agent modifie des fichiers avec succès, il crée automatiquement une pull request (demande de fusion) à la fin de la tâche.

<div id="rate-limits">
  ## Limites de débit
</div>

L’API de l’agent est soumise aux limites suivantes :

* 100 utilisations par projet Mintlify et par heure

<div id="suggested-usage">
  ## Utilisation recommandée
</div>

Pour de meilleurs résultats, utilisez le [hook useChat d’ai-sdk](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat) pour envoyer des requêtes et gérer les réponses.


## OpenAPI

````yaml fr/admin-openapi.json POST /v1/agent/{projectId}/job
openapi: 3.0.1
info:
  title: Mintlify Admin API
  description: >-
    Une API pour les opérations administratives, y compris les mises à jour de
    la documentation et la gestion des agents.
  version: 2.0.0
servers:
  - url: https://api.mintlify.com
security:
  - bearerAuth: []
paths:
  /v1/agent/{projectId}/job:
    post:
      summary: Créer une tâche d’agent (v1)
      description: "Obsolète\_: utilisez plutôt [v2 create agent job](/api/agent/v2/create-agent-job). Crée une nouvelle tâche d’agent capable de générer et de modifier de la documentation à partir des messages fournis et des informations de branche.\n\nAuthentifiez-vous avec une clé d'API administrateur."
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: >-
            L’ID de votre projet. Vous pouvez le copier depuis la page [API
            keys](https://dashboard.mintlify.com/settings/organization/api-keys)
            de votre Dashboard.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - messages
              properties:
                branch:
                  type: string
                  description: >-
                    Le nom de la branche Git sur laquelle l’agent doit
                    travailler. S’il est omis, l’agent génère un nom de branche
                    à partir du contenu des messages.
                messages:
                  type: array
                  description: >-
                    Une liste de messages à fournir à l’agent. Une invite
                    système par défaut est toujours ajoutée automatiquement au
                    début. Vous n’avez donc généralement besoin d’inclure que
                    des messages utilisateur.
                  items:
                    type: object
                    required:
                      - role
                      - content
                    properties:
                      role:
                        type: string
                        enum:
                          - system
                          - user
                          - assistant
                        description: >-
                          Le rôle de l’expéditeur du message. Utilisez `user`
                          pour les instructions de tâche. Utilisez `system` pour
                          ajouter des instructions supplémentaires après
                          l’invite système par défaut (sans la remplacer).
                          Utilisez `assistant` pour fournir des exemples de
                          réponses de l’Assistant pour le prompting few-shot.
                      content:
                        type: string
                        description: Le contenu du message.
                asDraft:
                  type: boolean
                  default: false
                  description: >-
                    Détermine si la pull request (demande de fusion) est créée
                    en mode brouillon ou non. Si la valeur est true, crée une
                    pull request (demande de fusion) en brouillon. Si la valeur
                    est false (par défaut), crée une pull request (demande de
                    fusion) prête à être examinée.
                model:
                  type: string
                  enum:
                    - sonnet
                    - opus
                  default: sonnet
                  description: >-
                    Le modèle d’IA à utiliser pour la tâche d’agent. Utilisez
                    `sonnet` pour un traitement plus rapide et plus économique.
                    Utilisez `opus` pour un traitement plus performant, mais
                    plus lent.
      responses:
        '200':
          description: >-
            Tâche d'agent créée avec succès. Retourne une réponse en flux avec
            des événements Server-Sent Events.
          headers:
            X-Session-Id:
              schema:
                type: string
              description: Identifiant unique de session pour la tâche d'agent créée.
            X-Branch-Name:
              schema:
                type: string
              description: Nom de la branche Git où l'agent effectue les modifications.
          content:
            text/event-stream:
              schema:
                type: string
                description: >-
                  Flux Server-Sent Events contenant les détails d'exécution et
                  les résultats de la tâche d'agent.
      deprecated: true
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        L'en-tête Authorization requiert un jeton Bearer. Utilisez une clé d'API
        administrateur. Il s'agit d'une clé secrète côté serveur. Générez-en une
        depuis la [page des clés
        d'API](https://dashboard.mintlify.com/settings/organization/api-keys) de
        votre Dashboard.

````

## Related topics

- [Créer une tâche d'agent](/docs/fr/api/agent/v2/create-agent-job.md)
- [Récupérer une tâche d’agent](/docs/fr/api/agent/v2/get-agent-job.md)
- [Vue d'ensemble des automatisations](/docs/fr/automations/index.md)