> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de problemas

> Soluciona problemas de configuracion, fuentes, presupuesto, cancelacion, trazas y costes en Hive Agents

Usa esta pagina cuando un Hive Agent no inicia, se pausa, falla preparando fuentes o muestra logs confusos.

## La ejecución dice que se requiere una API key Default <a href="#default-api-key" id="default-api-key" />

Las ejecuciones desde el dashboard requieren una API key **Default** activa. Abre [API Keys](../workspace/api-keys), crea o reactiva una key y marcala como Default.

## Falló la preparación de fuentes <a href="#source-preparation-failed" id="source-preparation-failed" />

Revisa que las URLs sean accesibles, los archivos sean compatibles, las Knowledge Bases esten activas, los items existan y los archivos pertenezcan al mismo workspace.

Abre la hoja de detalle y revisa el error de la fuente.

## La ejecución está bloqueada <a href="#blocked" id="blocked" />

Una ejecucion bloqueada normalmente necesita aprobacion de presupuesto o llego a un gate de presupuesto. Revisa **Budget Settings** y aprueba o rechaza el enlace. La ejecucion tambien puede bloquearse durante Compose, incluso despues de que todos los nodos esten verificados.

## La ejecución falló después del máximo de pases <a href="#max-passes" id="max-passes" />

La ejecucion puede detenerse por **Max repeat passes** o porque la composicion final falla despues de **Max compose attempts**. Lee las razones del verifier o del compose check y ajusta **PLAN**, **EXECUTE**, **VERIFY**, **REPEAT** o **COMPOSE**.

Si los nodos estan verificados pero Compose fallo, abre la seccion de respuesta final y lee el problema de Compose. Las salidas de nodos verificados siguen disponibles como detalle de soporte, pero la respuesta compuesta final no paso el check de ensamblado.

Usa **Best effort** solo si la salida parcial de nodos verificados es aceptable antes de la composicion final.

## La ejecución fue cancelada <a href="#cancelled" id="cancelled" />

Hard stop cancela rapido. Partial result detiene trabajo nuevo, deja terminar trabajo iniciado y conserva salida verificada aunque el estado sea `cancelled`. Si cancelas durante Compose, el intento en curso puede terminar, pero no se programan mas intentos de Compose.

## Los detalles de traza se ven retrasados o incompletos <a href="#trace-delay" id="trace-delay" />

Las trazas de AgentRun hijo pueden llegar despues de la etapa padre. Actualiza la hoja de detalle cuando termine el hijo.

## La ejecución costó más de lo esperado <a href="#cost-high" id="cost-high" />

Revisa **Max Concurrent Nodes**, pases, **Max compose attempts**, fuentes, numero de nodos, modelos, herramientas, nodos rechazados que se repiten y reintentos de composicion.

Ver también: [Budget Approval](./budget-approval) and [Logs](./logs).