> ## 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.

# Crear tarea de agente

> Crea un nuevo trabajo de agente capaz de generar y editar documentación basándose en los mensajes proporcionados y en la información de la branch.

Este endpoint crea un trabajo del agente a partir de los mensajes proporcionados y la información de la branch. El trabajo se ejecuta de forma asíncrona y devuelve una respuesta en streaming con los detalles de la ejecución y los resultados.

Si no existe una branch, el agente crea una. Si los archivos se editan correctamente, al finalizar el trabajo se crea automáticamente una solicitud de extracción.

<div id="rate-limits">
  ## Límites de tasa
</div>

La API del agente tiene los siguientes límites:

* 100 usos por proyecto de Mintlify por hora

<div id="suggested-usage">
  ## Uso recomendado
</div>

Para obtener mejores resultados, utiliza el [hook useChat de ai-sdk](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat) para enviar solicitudes y gestionar las respuestas.


## OpenAPI

````yaml es/admin-openapi.json post /agent/{projectId}/job
openapi: 3.0.1
info:
  title: Mintlify Admin API
  description: >-
    Una API de operaciones administrativas, incluidas las actualizaciones de
    documentación y la gestión de agentes.
  version: 1.0.0
servers:
  - url: https://api.mintlify.com/v1
security:
  - bearerAuth: []
paths:
  /agent/{projectId}/job:
    post:
      summary: Crear tarea de agente
      description: >-
        Crea un nuevo trabajo de agente capaz de generar y editar documentación
        basándose en los mensajes proporcionados y en la información de la
        branch.
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: >-
            El ID de tu proyecto. Puedes copiarlo desde la página de [API
            keys](https://dashboard.mintlify.com/settings/organization/api-keys)
            en tu panel de control.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - branch
                - messages
              properties:
                branch:
                  type: string
                  description: >-
                    El nombre de la branch de Git en la que debe trabajar el
                    agente; se creará automáticamente si no existe
                messages:
                  type: array
                  description: >-
                    Una lista de mensajes para proporcionar al agente. Siempre
                    se antepone automáticamente un mensaje del sistema
                    predeterminado, por lo que normalmente solo es necesario
                    incluir mensajes de usuario.
                  items:
                    type: object
                    required:
                      - role
                      - content
                    properties:
                      role:
                        type: string
                        enum:
                          - system
                          - user
                        description: >-
                          La función del remitente del mensaje. Usa `user` para
                          las instrucciones de la tarea. Usa `system` para
                          añadir instrucciones suplementarias que se añaden
                          después del prompt de sistema predeterminado (no lo
                          reemplazan).
                      content:
                        type: string
                        description: El contenido del mensaje.
                asDraft:
                  type: boolean
                  default: true
                  description: >-
                    Controla si la solicitud de extracción se crea en modo
                    borrador o en modo no borrador. Cuando es true, crea una
                    solicitud de extracción en borrador. Cuando es false, crea
                    una solicitud de extracción normal (no borrador) lista para
                    revisión.
                model:
                  type: string
                  enum:
                    - sonnet
                    - opus
                  default: sonnet
                  description: >-
                    Modelo de IA que se utilizará para la tarea del agente. Usa
                    `sonnet` para un procesamiento más rápido y económico. Usa
                    `opus` para un procesamiento más potente, pero más lento.
      responses:
        '200':
          description: >-
            Trabajo de agente creado correctamente (respuesta en streaming). El
            encabezado X-Session-Id se devuelve en la respuesta
          headers:
            X-Message-Id:
              schema:
                type: string
              description: Identificador del mensaje para el trabajo creado
          content:
            text/plain:
              schema:
                type: string
                description: >-
                  Respuesta en streaming que contiene los detalles y resultados
                  de la ejecución de la tarea del agente.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        El encabezado Authorization requiere un token Bearer. Crea una [Admin
        API Key](https://dashboard.mintlify.com/settings/organization/api-keys)
        aquí.

````