Skip to content

docs(locadex): update translations on main #1513

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
locadex-agent merged 1 commit into from
Oct 2, 2026
Merged

docs(locadex): update translations on main #1513

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions es/api-reference/errors.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Para las respuestas 429, Firecrawl incluye una cabecera `Retry-After` (en segund

## Agent {#agent}

Errores específicos de [`/agent`](/es/features/agent) y de sus endpoints de estado, traza, snapshot y cancelación. Los endpoints de traza y snapshot retransmiten sin cambios el cuerpo de error del servicio ascendente, por lo que pueden responder con un cuerpo que omita el campo `success` descrito anteriormente; compruebe el código de estado HTTP y la cadena `error`.
Errores específicos de [`/agent`](/es/features/agent) y de sus endpoints de estado, traza, snapshot y cancelación. Los endpoints de traza y snapshot retransmiten sin cambios el cuerpo de error del servicio upstream, por lo que pueden responder con un cuerpo que omita el campo `success` descrito anteriormente; compruebe el código de estado HTTP y la cadena `error`.

| HTTP | `error` (mensaje típico) | Causa | Solución | Reintentable |
| ---- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
Expand All @@ -66,7 +66,7 @@ Errores específicos de [`/agent`](/es/features/agent) y de sus endpoints de est
| 409 | `Agent is already cancelled` | Se solicitó la cancelación de una ejecución que ya se estaba cancelando. | Consulte `GET /v2/agent/{jobId}`. Una ejecución cancelada informa `failed` con un mensaje de cancelación. | No |
| 500 | `Failed to passthrough agent request.` | El servicio del agente rechazó el trabajo al enviarlo. | Reintente con backoff. Si el problema persiste, contacte con soporte e incluya el ID de solicitud. | Sí, con backoff |

Una ejecución que alcanza su límite de `maxCredits` no devuelve un error HTTP. Finaliza como un trabajo fallido. Consulte el endpoint de estado y obtendrá `status: "failed"` con un mensaje de error por límite de créditos, sin `data` y con `creditsUsed: 0`, ya que las ejecuciones fallidas no se facturan. En la traza, el mismo resultado aparece como un evento `run.finished` con `outcome: "credit_limit_reached"`.
Una ejecución que alcanza su límite de `maxCredits` no devuelve un error HTTP. Finaliza como un trabajo fallido. Consulte el endpoint de estado y obtendrá `status: "failed"` con `stopReason: "credit_limit_reached"`, un mensaje de error por límite de créditos, sin `data` y con `creditsUsed: 0`, ya que las ejecuciones fallidas no se facturan. La respuesta también puede incluir un resultado parcial `partial` de mejor esfuerzo. Compruebe `stopReason` en lugar de comparar el texto del error, y consulte [Gestión de detenciones por límite de créditos](/es/features/agent#handling-credit-limit-stops) para saber cómo usar un resultado parcial y continuar la ejecución. En la traza, el mismo resultado aparece como un evento `run.finished` con `outcome: "credit_limit_reached"`.

### Códigos de error de la traza {#trace-error-codes}

Expand Down
20 changes: 19 additions & 1 deletion es/api-reference/v2-openapi.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6305,7 +6305,7 @@
"type": "number"
},
"data": {
"description": "Los datos extraídos (solo disponibles cuando el estado es \"completed\")",
"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": {
Expand All @@ -6325,6 +6325,10 @@
"format": "date-time",
"type": "string"
},
"message": {
"description": "Una nota del agente sobre el resultado. Si la ejecución falló al alcanzar el límite de créditos, puede explicar qué partes están incompletas.",
"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.",
Expand All @@ -6335,6 +6339,13 @@
],
"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"
},
"status": {
"enum": [
"processing",
Expand All @@ -6343,6 +6354,13 @@
],
"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"
}
Expand Down
18 changes: 18 additions & 0 deletions es/api-reference/webhooks-openapi.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -566,6 +566,24 @@
"creditsUsed": {
"description": "Créditos totales consumidos antes del error.",
"type": "number"
},
"message": {
"description": "Una breve nota sobre lo que está incompleto, si está disponible.",
"type": "string"
},
"partial": {
"description": "JSON recuperado, en la medida de lo posible, de la ejecución incompleta, si está disponible. Puede que falten filas o campos, así que no lo consideres un resultado completo."
},
"partialSchemaValid": {
"description": "Indica si `partial` cumple con el esquema JSON de la solicitud. Solo aparece si `partial` está presente y la solicitud incluía un `schema`.",
"type": "boolean"
},
"stopReason": {
"description": "Motivo por el que la ejecución se detuvo antes de tiempo. `credit_limit_reached` significa que la ejecución alcanzó el límite definido en `maxCredits`.",
"enum": [
"credit_limit_reached"
],
"type": "string"
}
},
"type": "object"
Expand Down
Loading
Loading