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

# Solución de problemas

> Resolvé problemas de conexión, tareas que no avanzan y dificultades de acceso a archivos con tus agentes.

## Falta una herramienta o falla la autenticación

Actualizá la lista de herramientas de tus agentes. Si la herramienta sigue sin aparecer o no podés iniciar sesión, volvé a conectar Rainbrand y completá la autenticación. Seguí el [inicio rápido con MCP](https://docs.rainbrand.com/es/mcp/getting-started.md).

Para conexiones con clave de API, comprobá que la clave esté completa y no se haya revocado. No incluyas credenciales en prompts ni en archivos del proyecto; consultá [Autenticación](https://docs.rainbrand.com/api/authentication.md) (en inglés).

## Una tarea sigue en curso

Pedí a tus agentes que consulten la operación existente. Una espera puede agotar su plazo mientras el trabajo continúa; iniciar la tarea de nuevo puede crear un duplicado.

| Tarea | Consultá el progreso con |
| - | - |
| Añadir una marca | `get_brand` |
| Editar una marca | `get_brand_edit` |
| Crear un Brief | `get_brief` |
| Generar un recurso | `get_generation` |
| Revisar un recurso | `get_review` |

Si la operación falla, leé su error antes de reintentar. Si necesita información, respondé a esa solicitud para que tus agentes puedan continuar.

## Una Review terminó con una advertencia sobre las pruebas

«Some evidence images couldn’t be saved» indica que los resultados y las notas de la Review están disponibles, pero faltan algunas o todas las imágenes de prueba. Usá las observaciones y las imágenes disponibles; que falte una imagen no significa que la comprobación haya fallado.

La API y MCP devuelven esta advertencia en `warnings` y omiten los enlaces a imágenes no disponibles. Consultá de nuevo la misma Review si no se pudieron emitir los enlaces. Iniciar otra Review vuelve a ejecutar las comprobaciones.

## Se rechazan los argumentos de una herramienta

Pedí a tus agentes que actualicen el esquema de entrada de la herramienta y corrijan los valores rechazados. En solicitudes de generación, comprobá también el esquema de entrada del modelo seleccionado. Reintentar con los mismos argumentos no resolverá el problema.

En [Herramientas](https://docs.rainbrand.com/es/mcp/tools.md) encontrarás las funciones disponibles y sus guías.

## Una solicitud alcanza el límite de frecuencia o se bloquea por facturación

Si se alcanza un límite de frecuencia, respetá el plazo de reintento indicado en la respuesta o el periodo de restablecimiento de [Créditos y límites](https://docs.rainbrand.com/api/usage-limits.md) (en inglés). Si hay un error de facturación, seguí su explicación y cualquier enlace para actuar sobre la cuenta.

Si el mensaje indica que la cuenta de facturación no está configurada, contactá a [support@rainbrand.com][rainbrand-support] e incluí el ID de facturación que aparece en el mensaje.

## Tus agentes no pueden acceder a un archivo

Una ruta de tu computadora o un enlace privado a un archivo adjunto pueden no ser accesibles para tus agentes. Usá el [selector de archivos](https://docs.rainbrand.com/es/guides/upload-files.md) para compartir archivos locales. Los agentes con acceso a archivos y capacidad de hacer solicitudes HTTP pueden subirlos directamente.

Si una subida venció, volvé a subir el archivo. Los archivos y la marca deben pertenecer al mismo equipo o cuenta personal.

## Un archivo devuelto es demasiado grande para leerlo mediante MCP

Los enlaces a archivos de Briefs y generaciones de Rainbrand se pueden abrir directamente por HTTPS o leer mediante MCP. Las lecturas por MCP devuelven el archivo original y admiten hasta 7 MiB (7.340.032 bytes) por archivo. Los archivos mayores devuelven un error de límite de tamaño; descargalos con el mismo enlace HTTPS. El límite se aplica a la lectura mediante MCP, no a la descarga normal ni a la vista previa de la herramienta.

Si un enlace ya no está disponible, volver a solicitarlo no restaura un archivo eliminado ni una subida caducada. Un error temporal de almacenamiento sí se puede reintentar.

## ¿Seguís sin poder continuar?

[Informá del problema](https://docs.rainbrand.com/es/guides/report-feedback.md) e indicá qué ocurrió y qué esperabas. Si necesitás ayuda para continuar una tarea bloqueada, contactá a [support@rainbrand.com][rainbrand-support].

[rainbrand-support]: mailto:support@rainbrand.com


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.