Comment votre IA travaille dans votre bureau

Cette page est surtout pour votre IA. Elle donne chaque règle que les outils du bureau respectent, pour que votre IA fasse juste du premier coup. Vous n'avez rien à apprendre.

Chaque séance commence par start

Votre IA appelle start une fois au début de chaque séance. La réponse donne votre cap, vos règles, le travail en cours, ce qui vous attend et le dernier résultat. Elle donne aussi un run_id : votre IA passe ce run_id à chaque appel qui écrit ou change quelque chose.

Les tâches

Tout le travail est une tâche sur le tableau. Pour travailler sur une tâche, votre IA doit d'abord la prendre avec pick_up et la garder. Une tâche qu'elle ne garde pas ne peut pas être changée.
Une tâche reste gardée 30 minutes. Chaque appel qui nomme la tâche la garde encore.
Une tâche gardée par quelqu'un d'autre, une étape du propriétaire ou une tâche que vous avez refusée ne peut pas être prise.
Un travail risqué n'est pris que si sa carte a les trois : done_when, check et risk.
Une nouvelle tâche a besoin d'un savoir-faire que le bureau possède (start les liste), d'un titre de 200 caractères au plus, et d'un done_when de 1 000 caractères au plus.
Chercher des tâches : number s'utilise seul. Les périodes vont de la date la plus ancienne à la plus récente. Les résultats couvrent au plus 366 jours à la fois.
Ce qui attend : department et since s'utilisent seulement quand il n'y a pas de numéro de tâche.

Notes et dépenses

Votre IA écrit ce qu'elle a fait et pourquoi dans une note sur la tâche (log). Une note fait 4 000 caractères au plus. Une dépense qu'elle note va de 0 à 100 dollars US.

Terminer une tâche

done demande une preuve : ce que votre IA a vu en faisant la vérification, pas la vérification refaite, et rien qui reste à remplir.
Un travail risqué, et toute tâche avec une proposition pour publier un site, importer des personnes ou des factures, supprimer un fichier ou créer une nouvelle entreprise, ne se termine qu'après un second regard et votre oui. Le second regard vient d'une nouvelle séance, avec le savoir-faire du second regard.
Une proposition qui attend encore votre oui bloque done. Attendez d'abord la réponse.

Nombres, clés et textes à remplir

Envoyez les nombres comme de simples nombres : 12, pas "12".
Aucun texte qui ressemble à une clé ou à un jeton, dans aucun champ ni fichier. Les clés ne passent jamais par une conversation.
Aucun texte à remplir dans ce qu'une personne lit : pas de [NAME], {{x}}, TODO, lorem ipsum, "To fill in" ni ___. Demandez plutôt au propriétaire ce qui manque.

Les outils qui s'ouvrent quand vous en avez besoin

Certains outils sont rangés dans des zones, comme online, money ou connections. tools_for montre les outils d'une zone. read_tool appelle un outil qui ne fait que lire, et use_tool appelle les autres. Ce que l'outil reçoit va sous args. Les outils de base, comme start, write et propose, s'appellent directement.

Les outils extérieurs

Les outils d'un service connecté s'appellent avec connector_call.

Un appel qui change quelque chose a besoin du number de la tâche.
Utilisez une request_key pour chaque appel différent. La même clé avec d'autres données est refusée.
Un appel qui attend le oui du propriétaire contient au plus 18 000 caractères de données.

Quand quelque chose est refusé

Un refus dit quoi corriger. Votre IA corrige et réessaie sans bruit. Elle ne vous donne que le résultat, en mots simples. Elle ne parle du côté technique que si vous le demandez, ou si vous devez faire quelque chose.