Solución de problemas
La mayoría de los problemas aparecen como un aviso: un mensaje que indica qué se detuvo y por qué. Esta página cubre los que las personas encuentran más a menudo.
Instalación y inicio
Sección titulada «Instalación y inicio»Windows dice que el instalador es de un editor desconocido. Las compilaciones aún no están firmadas digitalmente. Seleccionar Más información y luego Ejecutar de todas formas.
La aplicación de macOS no se actualiza por sí misma. Las aplicaciones de macOS sin firmar no pueden hacerlo. Descargar la nueva versión desde la página de versiones e instalarla sobre la anterior.
La aplicación dice que su puerto está ocupado. Algo más está escuchando donde el proceso local de la aplicación (el gateway) quiere iniciar, a menudo una copia antigua que no se cerró. El panel nombra el proceso y ofrece finalizarlo (Cerrar ese gateway para un Perfica antiguo, de lo contrario Cerrar seguido de su nombre o su PID), o Usar otro puerto esta vez solo para esta sesión.
La aplicación dice El gateway no pudo iniciar. Su proceso local falló o no respondió en un minuto. El panel muestra las últimas líneas que imprimió. Presionar Intentar de nuevo; si falla otra vez, informar del error con esas líneas.
Cerré la ventana y la aplicación sigue ejecutándose. Eso es a propósito, para que los loops sigan funcionando. Salir con Salir de Perfica en el menú de la bandeja.
Un loop se detuvo
Sección titulada «Un loop se detuvo»Un loop que se detiene indica por qué en un aviso y en su panel en el canvas. Las razones habituales:
| Lo que dice la aplicación | Qué hacer |
|---|---|
| El loop alcanzó sus ejecuciones máximas o sus límites de errores | Leer la pestaña Log del Manager para ver qué bubble siguió fallando. Corregir la causa o aumentar el límite en los ajustes del loop, luego presionar Play. |
| No queda trabajo pendiente: las tarjetas están esperando en Draft | Aprobar las tarjetas en las que se desea trabajar, luego presionar Play. |
| Las tarjetas están esperando entre sí | Dos o más tarjetas dependen una de la otra. Abrir el Task Book y presionar Dejar de esperar en una de ellas. |
| Se agotó la cuota del modelo, con la hora en que intentará de nuevo | Nada: el loop comienza de nuevo por sí solo a esa hora y sigue intentándolo mientras el tablero se deje solo. Presionar Play para intentar ahora, Añadir una clave de pago para continuar sin esperar, o usar un pool. |
| El proveedor del modelo dejó de responder | El proveedor no respondió incluso después de que Perfica preguntó de nuevo tres veces durante unos siete segundos. No se contó ningún error. Comprobar que está en ejecución, luego presionar Play. |
| El presupuesto de pasadas del tablero está agotado | Las ejecuciones máximas de cada loop, sumadas, son el presupuesto del tablero. Aumentar el máximo en el loop que se desea que avance más. |
Después de solucionar una detención, Play borra los recuentos de errores del loop y lo inicia de nuevo.
Una pasada terminó en ERROR
Sección titulada «Una pasada terminó en ERROR»ERROR significa que el agente nunca se ejecutó realmente. Causas comunes:
- La clave pertenece a otro proveedor. Un bubble apunta a una clave guardada para un proveedor diferente. Elegir la clave correcta en el inspector del bubble.
- El modelo no puede hacer el trabajo. Algunos modelos pequeños no pueden llamar herramientas ni mantener la estructura de la respuesta. Elegir un modelo más grande para ese bubble.
- Una imagen y nadie para verla. El modelo del bubble no puede ver imágenes y no hay ningún modelo de visión configurado. Establecer uno en la página Models bajo Helper models.
Comandos y herramientas
Sección titulada «Comandos y herramientas»“Un comando fue rechazado porque no se pudo aislar en el sandbox”. El sandbox está activo pero su backend no está listo. Ajustes › Autonomy › Command sandbox muestra el paso único para solucionarlo y el comando exacto para copiar. Los comandos permanecen rechazados hasta entonces; nunca se ejecutan sin sandbox.
“Los agentes necesitan Git para Windows para ejecutar líneas de comandos”. Los agentes necesitan Git para Windows para ejecutar cadenas de comandos y redirecciones. Instalarlo. Nada necesita reiniciarse: el siguiente comando lo busca de nuevo.
Un comando espera una respuesta que nunca llega. Las aprobaciones aparecen en la ventana de la aplicación. Si no hay ninguna ventana abierta, el comando se rechaza en lugar de esperar.
“Los agentes necesitan un navegador para ver la aplicación en ejecución”. La revisión visual y las herramientas de navegador necesitan Chrome, Edge o un Chromium descargado. Ajustes › Autonomy › Agent browser ofrece la descarga. Nada necesita reiniciarse.
La búsqueda web dice que no está disponible. La búsqueda integrada no respondió, por lo que los resultados provinieron únicamente de npm, GitHub, Stack Overflow, MDN y Wikipedia. Se reinicia en la siguiente búsqueda. Una clave de Brave o Tavily envía cada búsqueda a ese servicio en lugar del integrado.
La vista previa
Sección titulada «La vista previa»La vista previa no inicia.
Las vistas previa necesitan un script dev o start en el archivo package.json del proyecto (o en una carpeta de primer nivel). Un tablero que aísla comandos en un sandbox no puede ejecutar uno. Si falló, la pestaña Report muestra el código de salida y las últimas líneas de su log.
No hay informe final después de un run. Solo los runs que se quedaron sin trabajo por sí mismos entregan un informe. Un run que se pausó o se detuvo, o uno que alcanzó un límite, no escribe un informe. Para obtener uno de todos modos, abrir la pestaña Report del Manager y presionar Escribir informe.