> ## Documentation Index > Fetch the complete documentation index at: https://firecrawl-capy-docs-factual-copy-fixes.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Obtener el estado del agente > ¿Eres un agente de IA que necesita una API key de Firecrawl? Consulta [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para obtener instrucciones de incorporación automática. ## OpenAPI ````yaml es/api-reference/v2-openapi.json GET /agent/{jobId} openapi: 3.0.0 info: contact: email: support@firecrawl.dev name: Firecrawl Support url: https://firecrawl.dev/support description: >- API para interactuar con los servicios de Firecrawl y realizar tareas de scraping y rastreo web. title: Firecrawl API version: v2 servers: - url: https://api.firecrawl.dev/v2 security: - bearerAuth: [] paths: /agent/{jobId}: parameters: - description: El ID de la tarea del agente in: path name: jobId required: true schema: format: uuid type: string get: tags: - Agent summary: Obtener el estado de una tarea de agente operationId: getAgentStatus responses: '200': content: application/json: schema: properties: creditsUsed: type: number data: description: >- Los datos extraídos (solo disponibles cuando el estado es "completed"). Nunca se incluyen en una ejecución fallida, ni siquiera si se detuvo al alcanzar su límite de créditos. type: object effort: description: >- Presupuesto de razonamiento utilizado para la ejecución del agente (solo presente en ejecuciones que especifican effort) enum: - low - medium - high type: string error: description: >- Mensaje de error (solo presente cuando el estado es `failed`) type: string exchange: $ref: '#/components/schemas/AgentExchangeSummary' expiresAt: format: date-time type: string message: description: >- Una nota del agente sobre el resultado. En el modo `chat`, las solicitudes de seguimiento que no piden datos nuevos se responden aquí en lugar de en `data`. Si la ejecución falló al alcanzar el límite de créditos, puede explicar qué partes están incompletas. type: string mode: enum: - extract - chat type: string model: default: spark-2 description: >- Configuración predefinida del modelo utilizada en la ejecución del agente. Cada nueva ejecución se realiza en spark-2; los nombres de Spark 1 solo aparecen en ejecuciones heredadas. enum: - spark-2 - spark-1-pro - spark-1-mini type: string partial: description: >- JSON recuperado en la medida de lo posible de una ejecución incompleta. Solo está presente en algunas ejecuciones fallidas, como las que alcanzaron `maxCredits`; nunca mientras la ejecución está en curso. Pueden faltar filas o campos, por lo que no debe tratarse como un resultado completo. partialSchemaValid: description: >- Indica si `partial` cumple con el esquema JSON de la solicitud. Solo está presente si se incluye `partial` y la solicitud incluía un `schema`. type: boolean pendingApproval: $ref: '#/components/schemas/AgentPendingApproval' status: enum: - processing - completed - failed type: string stopReason: description: >- Motivo por el que una ejecución fallida se detuvo antes de tiempo. `credit_limit_reached` significa que la ejecución alcanzó el límite establecido en `maxCredits`. Solo está presente cuando el estado es failed. enum: - credit_limit_reached type: string success: type: boolean suggestions: description: >- Solicitudes de seguimiento que el agente propone para el siguiente turno del hilo. items: properties: label: type: string prompt: type: string type: object type: array threadId: description: El hilo al que pertenece esta ejecución. format: uuid type: string threadTurn: description: El turno de esta ejecución en el hilo, empezando por 1. type: integer type: object description: Respuesta correcta '400': content: application/json: schema: properties: error: example: Invalid job ID format. Job ID must be a valid UUID. type: string type: object description: Solicitud incorrecta — el ID de trabajo no es un UUID válido. '404': content: application/json: schema: properties: error: example: Agent job not found type: string type: object description: No se encontró el trabajo del agente security: - bearerAuth: [] components: schemas: AgentExchangeSummary: description: >- Lo que hizo la ejecución con Alexandria. `toolkits` y `requireApproval` son los valores efectivos de la ejecución tras aplicar la herencia del hilo. properties: creditsUsed: description: >- Créditos consumidos por las llamadas a providers, o null si se desconocen. nullable: true type: number enabled: type: boolean onTermsRequired: enum: - skip - ask type: string paidCalls: description: Llamadas de pago a providers realizadas durante la ejecución. type: integer requireApproval: type: boolean requiresAction: description: >- Solo con `onTermsRequired: "ask"`, cuando una solicitud de aceptación de condiciones puso fin al turno: las llamadas para ver y aceptar las condiciones de cada provider. Ninguna de estas llamadas se ejecuta automáticamente, y solo se debe llamar a `terms/accept` después de que tu usuario acepte explícitamente las condiciones. properties: approvalId: description: >- El `pendingApproval` de tipo `terms` al que debes responder una vez aceptadas las condiciones. type: string providers: items: properties: accept: description: >- La llamada a `terms/accept`, en el formato `{ provider, capability, options }` para `alexandria` en `/v2/scrape`. type: object adds: type: string capability: type: string digest: description: >- null si el catálogo no publicó ningún hash; `terms/show` lo devuelve. nullable: true type: string name: type: string provider: type: string show: description: >- La llamada a `terms/show`, en el formato `{ provider, capability, options }` para `alexandria` en `/v2/scrape`. type: object url: type: string version: type: string type: object type: array type: enum: - accept_terms type: string type: object skippedProviders: description: >- Providers que habrían sido útiles, pero cuyas condiciones de uso de datos tu equipo aún no ha aceptado. Se aplica a cualquier modo de `onTermsRequired`. items: properties: adds: description: Lo que habría aportado el provider. type: string capability: type: string name: type: string provider: type: string reason: enum: - terms_required type: string termsUrl: description: Dónde se aceptan las condiciones en el Dashboard. type: string version: description: La versión de las condiciones. type: string type: object type: array toolkits: description: >- Providers fijados. Si el campo está vacío o ausente, se incluyen todos los providers que el equipo puede usar. items: type: string type: array type: object AgentPendingApproval: description: >- La pregunta que interrumpió el turno. Respóndela en el siguiente turno del hilo con `exchange.approve` o `exchange.decline`. properties: calls: description: >- Las llamadas de pago pendientes de aprobación. Vacío en una aprobación de tipo `terms`. items: properties: capability: type: string creditsEstimate: description: Créditos estimados, o null si se desconocen. nullable: true type: number id: description: >- Pasa los identificadores en `exchange.approve.callIds` para aprobar solo algunas llamadas. type: string input: description: Las opciones con las que se ejecutaría la llamada. type: object more: description: >- Los datos de entrada adicionales con los que se ejecutaría la misma llamada. items: type: object type: array provider: type: string type: object type: array id: description: Envía esto como `approvalId`. type: string kind: description: >- `calls`: llamadas de pago a providers pendientes de autorización por `requireApproval`. `terms`: providers cuyas condiciones de uso de datos deben aceptarse (`onTermsRequired: "ask"`). Este campo no está presente en los elementos creados antes de que existieran las solicitudes de aceptación de condiciones; esos elementos son de tipo `calls`. enum: - calls - terms type: string reason: description: Por qué el agente quiere realizar estas llamadas. type: string resolution: description: >- null hasta que se responda a la solicitud de aprobación en un turno posterior. nullable: true properties: always: type: boolean approved: type: boolean byRunId: type: string callIds: items: type: string type: array type: object terms: description: >- En una aprobación de tipo `terms`, los providers cuyas condiciones deben aceptarse. items: properties: adds: description: Lo que aportaría el provider. type: string capability: type: string digest: description: >- null si el catálogo no publicó ningún hash; `terms/show` lo devuelve. nullable: true type: string name: type: string provider: type: string url: description: Dónde se aceptan las condiciones en el Dashboard. type: string version: description: La versión de las condiciones. type: string type: object type: array type: object securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.