Comment dépanner l’analyse et les connexions d’assistants dans AVE.
Diagnostiquez une analyse qui ne démarre pas, des médias encore en traitement, une CLI introuvable dans AVE ou un client MCP en attente d’AVE.
Identifiez le parcours qui échoue.
AVE dispose de trois systèmes liés mais distincts. Commencez par celui dont le statut ou l’action pose problème.
- L’Analyse sur l’appareil utilise Compréhension visuelle et Transcription pour créer un contexte local des médias.
- Les Assistants installés utilisent Codex CLI, Claude CLI ou Qwen CLI depuis la zone de message d’AVE.
- Les connexions MCP externes permettent à Codex CLI ou Claude Code de travailler avec AVE depuis le client externe.
Qwen CLI relève du parcours des assistants installés. Il n’apparaît pas comme connexion MCP externe dans AVE 1.2.2.
L’analyse n’est pas prête.
- Ouvrez Réglages > Analyse.
- Vérifiez Compréhension visuelle et Transcription séparément.
- Terminez tout téléchargement de modèle ou d’environnement d’exécution demandé.
- Choisissez Vérifier à nouveau après avoir corrigé la configuration.
- Testez un court MP4 ou MOV connu avant de relancer un lot.
Si AVE ne trouve pas ou ne peut pas lire le moteur inclus, quittez puis rouvrez l’application installée. Réinstallez la version actuelle d’AVE si le moteur inclus reste indisponible.
Les médias sont en attente ou encore en traitement.
Consultez la barre d’état pour connaître le média actif et le nombre en attente. Un lot s’exécute en file, et les sources longues peuvent prendre plusieurs minutes.
- Gardez AVE ouvert pendant l’analyse demandée.
- Gardez les fichiers sources connectés et lisibles.
- Ne soumettez pas plusieurs fois le même média alors que son analyse est déjà en cours.
- Si la file est inactive, vérifiez le statut du modèle dans les réglages d’analyse et réessayez avec un média.
La recherche ne trouve pas le moment attendu.
Vérifiez d’abord que l’analyse concernée est terminée. Adaptez ensuite la requête aux éléments disponibles :
- Utilisez les paroles exactes ou une reformulation proche pour rechercher dans la transcription.
- Utilisez des objets, actions, lieux, cadrages ou détails visibles pour la recherche visuelle.
- Prévisualisez chaque candidat avant de l’utiliser dans un montage.
L’analyse fournit des candidats étayés, pas des identités garanties. Si une personne, un produit ou un lieu récurrent compte, vérifiez et enregistrez le moment source précis avec Mémoire des séquences.
Une CLI installée est introuvable ou non connectée.
- Exécutez la CLI directement dans Terminal avec le même utilisateur macOS.
- Terminez le parcours de connexion propre à la CLI.
- Ouvrez Réglages > Assistant dans AVE.
- Choisissez Vérifier la connexion au compte.
- Redémarrez AVE si la CLI a été installée alors qu’AVE était ouvert.
Introuvable signifie qu’AVE ne localise pas l’exécutable. Connexion au compte requise signifie qu’il l’a trouvé, mais que le fournisseur nécessite une configuration du compte. Prêt signifie qu’AVE a vérifié les deux.
MCP est en attente, déconnecté ou nécessite une mise à jour.
Ouvrez Réglages > Connexions et consultez le statut de ce client précis.
- Redémarrage nécessaire : quittez complètement Codex ou Claude Code et rouvrez-le pour charger la connexion.
- En attente de l’assistant : la configuration existe, mais aucun client actif ne s’est encore connecté.
- Déconnecté : réactivez le client, puis redémarrez-le pour qu’il lise l’identifiant renouvelé.
- Actualiser la connexion : laissez AVE actualiser la configuration du client, puis redémarrez celui-ci.
La passerelle AVE est locale au même Mac. Il ne s’agit pas d’un point de terminaison public, d’une connexion ChatGPT cloud ou d’un connecteur Claude Desktop.
Une action MCP est bloquée.
Développez les réglages d’accès du client et vérifiez qu’un périmètre correspond à l’action demandée. Lire un projet, importer des médias, proposer des modifications, les appliquer, gérer la Mémoire des séquences et exporter sont des autorisations distinctes.
Si AVE demande une approbation, vérifiez le projet, la séquence, les sources et les actions. Gardez Approuver pour moi désactivé pendant le diagnostic. Si le projet a changé après la préparation d’un processus, actualisez son état et préparez à nouveau le travail.
Créez un rapport d’assistance si le problème se reproduit.
- Reproduisez le problème une fois avec le plus petit projet ou fichier utile.
- Copiez le statut, l’erreur ou le message de récupération exact affiché par AVE.
- Ouvrez Réglages > À propos et choisissez Créer un rapport d’assistance. Les écrans de configuration de l’analyse peuvent aussi proposer cette action lorsqu’un composant local échoue.
- Indiquez la version d’AVE, le modèle du Mac, la version de macOS, l’assistant ou modèle en cause et les étapes permettant de reproduire le problème.
- Envoyez le rapport à support@tinythings.app.
Protégez les médias clients. Ne joignez pas de médias sources privés sauf si cela est nécessaire, autorisé et que vous comprenez ce que vous envoyez. Commencez par le rapport d’assistance et une courte description.