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

# Crear trabajo del agente (v1)

> En desuso: usa [v2 create agent job](/api/agent/v2/create-agent-job) en su lugar. Crea un nuevo trabajo del agente que puede generar y editar documentación según los mensajes proporcionados y la información de la branch.

<Warning>Este endpoint está en desuso. Usa el endpoint [crear trabajo del agente v2](/es/api/agent/v2/create-agent-job) en su lugar.</Warning>

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 el agente edita los archivos correctamente, crea automáticamente una solicitud de extracción al finalizar el trabajo.

<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 /v1/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: 2.0.0
servers:
  - url: https://api.mintlify.com
security:
  - bearerAuth: []
paths:
  /v1/agent/{projectId}/job:
    post:
      summary: Crear trabajo del agente (v1)
      description: >-
        En desuso: usa [v2 create agent job](/api/agent/v2/create-agent-job) en
        su lugar. Crea un nuevo trabajo del agente que puede generar y editar
        documentación según los mensajes proporcionados y la información de la
        branch.
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: >-
            El ID de tu proyecto. Se puede copiar desde la página de [API
            keys](https://dashboard.mintlify.com/settings/organization/api-keys)
            en tu dashboard.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - messages
              properties:
                branch:
                  type: string
                  description: >-
                    El nombre de la branch de Git en la que debe trabajar el
                    agente. Si se omite, el agente genera un nombre de branch a
                    partir del contenido del mensaje.
                messages:
                  type: array
                  description: >-
                    Una lista de mensajes para proporcionar al agente. Siempre
                    se antepone automáticamente un prompt del sistema
                    predeterminado, por lo que normalmente solo necesitas
                    incluir mensajes del usuario.
                  items:
                    type: object
                    required:
                      - role
                      - content
                    properties:
                      role:
                        type: string
                        enum:
                          - system
                          - user
                          - assistant
                        description: >-
                          El rol del remitente del mensaje. Usa `user` para las
                          instrucciones de la tarea. Usa `system` para agregar
                          instrucciones complementarias que se añaden después
                          del prompt del sistema predeterminado (no lo
                          reemplaza). Usa `assistant` para proporcionar
                          respuestas de ejemplo del assistant para el prompting
                          de pocos ejemplos.
                      content:
                        type: string
                        description: El contenido del mensaje.
                asDraft:
                  type: boolean
                  default: false
                  description: >-
                    Controla si la solicitud de extracción se crea en modo
                    borrador o en modo normal. Cuando es true, crea una
                    solicitud de extracción en borrador. Cuando es false
                    (predeterminado), crea una solicitud de extracción regular
                    lista para revisión.
                model:
                  type: string
                  enum:
                    - sonnet
                    - opus
                  default: sonnet
                  description: >-
                    El modelo de IA que se usará para el trabajo del agente. Usa
                    `sonnet` para un procesamiento más rápido y rentable. Usa
                    `opus` para un procesamiento más capaz, pero más lento.
      responses:
        '200':
          description: >-
            Tarea de agente creada correctamente. Devuelve una respuesta en
            streaming con Server-Sent Events.
          headers:
            X-Session-Id:
              schema:
                type: string
              description: Identificador único de sesión para la tarea de agente creada.
            X-Branch-Name:
              schema:
                type: string
              description: Nombre de la rama Git donde el agente realiza los cambios.
          content:
            text/event-stream:
              schema:
                type: string
                description: >-
                  Flujo Server-Sent Events que contiene los detalles de
                  ejecución y resultados de la tarea de agente.
      deprecated: true
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        El encabezado Authorization requiere un token de tipo Bearer. Usa una
        clave de API de administrador (con el prefijo `mint_`). Esta es una
        clave secreta del lado del servidor. Genera una clave en la [página de
        claves de
        API](https://dashboard.mintlify.com/settings/organization/api-keys) de
        tu dashboard.

````

## Related topics

- [Vista general de automatizaciones](/docs/es/automations/index.md)
- [skill.md](/docs/es/ai/skillmd.md)
- [Visibility](/docs/es/components/visibility.md)