Limites et dépannage
Limites
Nombre d'appels
Une connexion peut faire 60 appels par minute. Au-delà, le serveur répond 429 (« Too many requests ») avec un en-tête Retry-After qui indique combien de secondes attendre avant de réessayer. Une longue série de lectures dans la même conversation peut atteindre cette limite.
Durée d'un appel
Un appel dure 60 secondes au plus. import_prompts s'arrête avant cette limite et renvoie les lignes qu'il n'a pas eu le temps d'écrire dans pendingRows, prêtes à être envoyées dans un nouvel appel.
Taille des réponses
Les réponses sont plafonnées pour ne pas saturer la mémoire de travail de l'assistant. Quand une réponse ne contient pas tout :
- un champ
truncateddit ce qui a été laissé de côté, et un total (total, ou un compteur propre à l'outil) donne le nombre réel d'éléments ; - les listes se lisent par pages :
limitrègle la taille,offsetpasse à la page suivante dansget_audit,cursoretnextCursordanslist_prompt_performance; - les textes longs sont coupés : 500 caractères par réponse de moteur, 20 000 pour le contenu d'une suggestion.
L'assistant lit ces champs et demande la suite quand il en a besoin. Si une réponse vous semble incomplète, demandez-lui de lire la page suivante.
Taille des lots
| Outil | Maximum par appel |
|---|---|
create_prompts | 50 prompts |
move_prompts, archive_prompts, activate_prompts, remove_prompts | 100 prompts |
set_suggestion_status | 50 suggestions |
import_prompts | 500 lignes |
Pour ajouter beaucoup de prompts, préférez import_prompts. Avec create_prompts, demandez à l'assistant d'envoyer les appels un par un : des appels lancés en même temps partagent le même quota et ne voient pas ce que les autres ont écrit.
Les outils CiteMe n'apparaissent pas
- Claude : vérifiez que le connecteur CiteMe est activé dans la conversation, via le menu « + », puis « Connectors ».
- ChatGPT : vérifiez que le mode développeur est activé et que CiteMe est activé dans la conversation.
- Paquet local : vérifiez que vous êtes connecté avec
citeme login. Si vous ne l'étiez pas au démarrage du client, les outils analytiques ne sont pas chargés : connectez-vous, puis redémarrez votre client. Les versions du paquet qui proxifient tous les outils hébergés (cli-citeme#56) remplacent ces outils par un seul,load_citeme_tools, que l'assistant peut appeler après la connexion, sans redémarrage.
Un nouvel outil n'apparaît pas
Votre client garde la liste des outils obtenue à la connexion. Quand CiteMe ajoute des outils, déconnectez puis reconnectez le connecteur CiteMe dans Claude, ou rafraîchissez-le dans les réglages de ChatGPT (sinon, supprimez-le et recréez-le). Avec le paquet local, redémarrez votre client.
L'assistant ne trouve pas le bon projet
Une connexion couvre une seule organisation, choisie selon les règles décrites dans Qui peut l'utiliser. Si le projet que vous cherchez appartient à une autre organisation, l'assistant ne le verra pas.
Quand l'organisation compte plusieurs projets, nommez le site concerné dans votre demande.
Messages d'erreur et refus
Les messages du serveur sont en anglais. Votre assistant les reformule en général.
| Le message parle de | Cause | Que faire |
|---|---|---|
| « Starter plan or above » | L'organisation est en Free. | Passez au forfait Starter ou supérieur, puis reconnectez le connecteur. |
| « on the Pro and Expert plans » | L'outil demande un forfait supérieur au vôtre. | Voir le forfait requis dans la référence des outils. |
| « edit access », « not a viewer seat » | Votre rôle est Lecteur. | Demandez le rôle Membre ou plus à un administrateur de l'organisation. |
| « authorized for reading only » | La connexion a été autorisée en lecture seule, par exemple quand vous étiez Lecteur. | Reconnectez le connecteur pour obtenir l'écriture. |
| « no longer a member », « no longer covers » | Vous avez été retiré de l'organisation, ou votre rôle a changé. | Reconnectez le connecteur si vous avez toujours accès, sinon voyez avec un administrateur. |
| « has used its … manual audits » ou « manual tracking runs » | Le quota du forfait est atteint pour la période. | Vérifiez ce qu'il reste avec get_usage, attendez la période suivante ou changez de forfait. |
| « already in progress », « still running », « already running » | Un traitement de la même sorte tourne déjà sur ce projet. Rien de nouveau n'est lancé ni consommé. | Attendez la fin. L'assistant peut suivre l'avancement avec get_audit, get_tracking_run, get_prompt_discovery ou get_social_analysis. |
| « Several projects exist, so pass projectId » | L'organisation a plusieurs projets et la demande n'en nomme aucun. | Précisez le site concerné. |
| « not found in this organization » | Le projet appartient à une autre organisation, ou l'identifiant est faux. | Vérifiez le projet. Voir L'assistant ne trouve pas le bon projet. |
| « CiteMe could not complete this call » | Erreur interne de CiteMe. | Réessayez dans un moment. Si l'erreur persiste, écrivez au support. |
| « Too many requests » | Plus de 60 appels en une minute. | Attendez quelques secondes. |
Contacter le support
Écrivez à support@citeme.io en précisant :
- l'assistant utilisé (Claude, ChatGPT, autre client, paquet local) ;
- la date et l'heure approximatives ;
- l'outil concerné et le message d'erreur.
N'envoyez jamais votre clé CLI ni un jeton d'accès.