> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer une tâche d’agent

> Crée un nouveau job d’agent qui peut générer et modifier la documentation à partir des messages fournis et des informations sur la branche.

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 des fichiers sont modifiés avec succès, une pull request (demande de fusion) est automatiquement créée à 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 /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: 1.0.0
servers:
  - url: https://api.mintlify.com/v1
security:
  - bearerAuth: []
paths:
  /agent/{projectId}/job:
    post:
      summary: Créer une tâche d’agent
      description: >-
        Crée un nouveau job d’agent qui peut générer et modifier la
        documentation à partir des messages fournis et des informations sur la
        branche.
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: >-
            Votre ID de projet. Vous pouvez le copier à partir de 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:
                - branch
                - messages
              properties:
                branch:
                  type: string
                  description: >-
                    Le nom de la branche Git sur laquelle l’agent doit
                    travailler (la branche sera automatiquement créée si elle
                    n’existe pas)
                messages:
                  type: array
                  description: >-
                    Une liste de messages à fournir à l’agent. Une invite
                    système par défaut est toujours automatiquement ajoutée en
                    premier, vous n’avez donc généralement besoin d’inclure que
                    les messages utilisateur.
                  items:
                    type: object
                    required:
                      - role
                      - content
                    properties:
                      role:
                        type: string
                        enum:
                          - system
                          - user
                        description: >-
                          Le rôle de l’expéditeur du message. Utilisez `user`
                          pour les instructions de la tâche. Utilisez `system`
                          pour ajouter des instructions supplémentaires qui
                          seront ajoutées après l’invite système par défaut
                          (sans la remplacer).
                      content:
                        type: string
                        description: Le contenu du message.
                asDraft:
                  type: boolean
                  default: true
                  description: >-
                    Détermine si la pull request (demande de fusion) est créée
                    en mode brouillon ou en mode non brouillon. Si la valeur est
                    true, une pull request brouillon est créée. Si la valeur est
                    false, une pull request classique (non brouillon) prête pour
                    relecture est créée.
                model:
                  type: string
                  enum:
                    - sonnet
                    - opus
                  default: sonnet
                  description: >-
                    Le modèle d’IA à utiliser pour la tâche de l’agent. Utilisez
                    `sonnet` pour un traitement plus rapide et économique.
                    Utilisez `opus` pour un traitement plus puissant, mais plus
                    lent.
      responses:
        '200':
          description: >-
            Job d’agent créé avec succès (réponse diffusée en continu).
            L’en-tête X-Session-Id est renvoyé dans la réponse
          headers:
            X-Message-Id:
              schema:
                type: string
              description: Identifiant du message pour la tâche créée
          content:
            text/plain:
              schema:
                type: string
                description: >-
                  Réponse diffusée en continu contenant les détails d’exécution
                  et les résultats de la tâche de l’agent.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        L’en-tête Authorization requiert un jeton Bearer. Créez une [clé API
        d’administration](https://dashboard.mintlify.com/settings/organization/api-keys)
        ici.

````