Dépannage

La plupart des problèmes apparaissent sous la forme d’une notification : un message qui indique ce qui s’est arrêté et pourquoi. Cette page aborde les cas les plus fréquents.

Installation et démarrage

Windows indique que l’installateur provient d’un éditeur inconnu. Les builds ne sont pas encore signées. Choisissez Informations complémentaires, puis Exécuter quand même.

L’application macOS ne se met pas à jour toute seule. Les applications macOS non signées ne le peuvent pas. Téléchargez la nouvelle version depuis la page des versions et installez-la par-dessus l’ancienne.

L’application indique que son port est occupé. Quelque chose d’autre écoute là où le processus local de l’application (le gateway) veut démarrer, souvent une ancienne copie qui ne s’est pas fermée. Le panneau nomme le processus et propose de l’arrêter (Arrêter ce gateway pour un ancien Perfica, sinon Arrêter suivi de son nom ou de son PID), ou bien Utiliser un autre port cette fois-ci pour cette session uniquement.

L’application indique The gateway could not start. Son processus local a planté ou n’a pas répondu en l’espace d’une minute. Le panneau affiche ses dernières lignes de texte. Appuyez sur Réessayer ; si cela échoue à nouveau, signalez le bogue en y joignant ces lignes.

J’ai fermé la fenêtre et l’application s’exécute toujours. C’est voulu, afin que les loops continuent. Quittez l’application avec Quitter Perfica dans le menu de la barre des tâches.

Arrêt d’un loop

Un loop qui s’arrête en indique la raison dans une notification et dans son panneau sur le canvas. Les causes habituelles :

Ce que dit l’application	Que faire
Le loop a atteint son max executions, ou ses error caps	Lisez l’onglet Log du Manager pour voir quelle bubble a échoué. Corrigez la cause, ou augmentez la limite dans les paramètres du loop, puis appuyez sur Lecture.
Il n’y a plus de travail : des cartes attendent dans Draft	Approuvez les cartes sur lesquelles vous voulez travailler, puis appuyez sur Lecture.
Des cartes s’attendent mutuellement	Deux cartes ou plus dépendent l’une de l’autre. Ouvrez le Task Book et appuyez sur Stop waiting sur l’une d’elles.
The model’s quota ran out, avec l’heure à laquelle il réessaiera	Rien : le loop redémarre de lui-même à cette heure-là et continue d’essayer tant que le tableau est laissé sans surveillance. Appuyez sur Lecture pour essayer maintenant, Add a paid key pour continuer sans attendre, ou utilisez un pool.
The model provider stopped answering	Le fournisseur n’a pas répondu même après qu’Perfica a relancé la demande trois fois sur environ sept secondes. Aucune erreur n’a été comptabilisée. Vérifiez qu’il fonctionne, puis appuyez sur Lecture.
Le pass budget du tableau est épuisé	Le total des exécutions maximales de chaque loop correspond au budget du tableau. Augmentez le maximum sur le loop que vous voulez faire aller plus loin.

Une fois que vous avez corrigé un arrêt, Lecture efface les compteurs d’erreurs du loop et le relance.

Fin d’une passe en ERROR

ERROR signifie que l’agent ne s’est jamais réellement exécuté. Causes courantes :

• La clé appartient à un autre fournisseur. Une bubble pointe vers une clé enregistrée pour un fournisseur différent. Sélectionnez la bonne clé dans l’inspecteur de la bubble.
• Le modèle ne peut pas faire le travail. Certains petits modèles ne peuvent pas appeler d’outils ni conserver la structure de la réponse. Choisissez un modèle plus grand pour cette bubble.
• Une image, et personne pour la voir. Le modèle de la bubble ne peut pas voir les images et aucun modèle de vision n’est défini. Définissez-en un sur la page Modèles sous Helper models.

Commandes et outils

“A command was refused because it could not be sandboxed”. Le sandbox est activé mais son backend n’est pas prêt. Paramètres › Autonomie › Command sandbox indique la seule étape pour y remédier et la commande exacte à copier. Les commandes restent refusées jusque-là ; elles ne s’exécutent jamais sans sandbox.

“Agents need Git for Windows to run command lines”. Les agents ont besoin de Git for Windows pour exécuter des chaînes de commandes et des redirections. Installez-le. Rien n’a besoin d’être redémarré : la commande suivante le recherchera à nouveau.

Une commande attend une réponse qui ne vient jamais. Les approbations apparaissent dans la fenêtre de l’application. Si aucune fenêtre n’est ouverte, la commande est refusée au lieu d’attendre.

“Agents need a browser to look at the running app”. La revue visuelle et les outils de navigateur ont besoin de Chrome, Edge ou d’un Chromium téléchargé. Paramètres › Autonomie › Agent browser propose le téléchargement. Rien n’a besoin d’être redémarré.

La recherche web indique qu’elle est indisponible. La recherche intégrée n’a pas répondu, les résultats proviennent donc uniquement de npm, GitHub, Stack Overflow, MDN et Wikipédia. Elle redémarre lors de la recherche suivante. Une clé Brave ou Tavily envoie chaque recherche vers ce service au lieu de celui intégré.

L’aperçu

L’aperçu ne veut pas démarrer. Les aperçus ont besoin d’un script dev ou start dans le fichier package.json du projet (ou dans un dossier de premier niveau). Un tableau qui isole les commandes dans un sandbox ne peut pas en exécuter. S’il a planté, l’onglet Rapport indique le code de sortie et les dernières lignes de son journal.

Pas de rapport final après une exécution. Seules les exécutions qui se sont retrouvées à court de travail de leur propre chef en génèrent un. Une exécution que vous avez mise en pause ou arrêtée, ou une qui a atteint une limite, n’écrit pas de rapport. Pour en obtenir un malgré tout, ouvrez l’onglet Report du Manager et appuyez sur Write report.