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

# Crear tarea de agente

> Crea un nuevo trabajo del agente que se ejecuta en segundo plano. El trabajo procesa el prompt de forma asíncrona; consulta periódicamente el endpoint get job para seguir el progreso. Si el agente edita archivos correctamente, se crea automáticamente una solicitud de extracción.

Este endpoint crea una tarea de agente en segundo plano. La tarea se ejecuta de forma asíncrona; usa el endpoint [get agent job](/es/api/agent/v2/get-agent-job) para consultar las actualizaciones de estado.

Si el agente edita los archivos correctamente, se crea automáticamente una solicitud de extracción y se rellena el campo `prLink` en la respuesta de la tarea.

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

* 100 usos por hora por proyecto de Mintlify

<div id="usage">
  ## Uso
</div>

```bash theme={null}
curl -X POST https://api.mintlify.com/v2/agent/{projectId}/job \
  -H "Authorization: Bearer mint_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Add a quickstart guide for the Python SDK"}'
```


## OpenAPI

````yaml es/admin-openapi.json POST /v2/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:
  /v2/agent/{projectId}/job:
    post:
      summary: Crear trabajo del agente
      description: >-
        Crea un nuevo trabajo del agente que se ejecuta en segundo plano. El
        trabajo procesa el prompt de forma asíncrona; consulta periódicamente el
        endpoint get job para seguir el progreso. Si el agente edita archivos
        correctamente, se crea automáticamente una solicitud de extracción.
      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 dashboard.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
              properties:
                prompt:
                  type: string
                  minLength: 1
                  description: La instrucción que debe ejecutar el agente.
      responses:
        '201':
          description: Trabajo del agente creado correctamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentJob'
        '400':
          description: Solicitud no válida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: superar el límite de solicitudes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    AgentJob:
      type: object
      properties:
        id:
          type: string
          description: Identificador único del trabajo del agente.
        status:
          type: string
          enum:
            - active
            - completed
            - archived
            - failed
          description: >-
            Estado actual del trabajo. `active` — el agente está procesando la
            instrucción en este momento. `completed` — el agente finalizó
            correctamente y es posible que se haya creado una PR (verificar
            `prLink`). `archived` — el trabajo se ha archivado. `failed` — el
            agente encontró un error irrecuperable. Consulte periódicamente
            hasta que el estado sea `completed`, `archived` o `failed`.
        source:
          type: object
          description: Información del repositorio de origen.
          properties:
            repository:
              type: string
              description: URL completa del repositorio de GitHub.
            ref:
              type: string
              description: branch de Git en la que trabaja el agente.
              nullable: true
        model:
          type: string
          description: El modelo de IA utilizado para esta tarea.
        prLink:
          type: string
          format: uri
          example: https://github.com/org/repo/pull/123
          description: >-
            URL de la solicitud de extracción de GitHub creada por el agente.
            `null` mientras la tarea siga `active` o si no se ha cambiado ningún
            archivo. Se completa cuando el agente crea correctamente una PR.
          nullable: true
        createdAt:
          type: string
          format: date-time
          description: Marca de tiempo de creación de la tarea.
        archivedAt:
          type: string
          format: date-time
          description: Marca de tiempo de archivado de la tarea.
          nullable: true
    Error:
      type: object
      properties:
        error:
          type: string
          description: Mensaje de error.
  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.

````