Faire calculer un assistant avec des fichiers¶

Un assistant peut répondre aux questions sur un fichier CSV ou Excel en exécutant du code dessus : totaux, nombres, comparaisons, un graphique ou un fichier nettoyé à télécharger. Il le fait sur un ordinateur qui lui est propre, qui repart de zéro à chaque réponse, n'a pas accès à internet et disparaît après la réponse. L'assistant a besoin de trois outils pour cela. Cette page explique où les trouver et comment les donner à un assistant, et ce que vous voyez quand votre organisation ne peut pas exécuter de code. Ce que font les membres dans le chat se trouve dans Faire analyser un tableur.

Les questions sur un tableur relèvent de ces outils, pas d'un stockage de données : un stockage de données conserve des enregistrements qu'une application écrit et lit, pas un fichier sur lequel quelqu'un a une question.

Les trois outils¶

Outil	Ce qu'il fait
Exécuter du code	Exécute une commande sur l'ordinateur de l'assistant, comme un script Python sur un fichier envoyé dans le chat, et relit ce qu'il a affiché.
Écrire un fichier sur l'ordinateur	Écrit un fichier texte sur l'ordinateur, comme un script que l'assistant exécute ensuite.
Lire ou exporter un fichier de l'ordinateur	Lit un fichier de l'ordinateur, ou le joint à la réponse pour le télécharger, comme un graphique ou un tableur nettoyé.

Donnez les trois à un assistant. Avec seulement Exécuter du code, il calcule bien, et les graphiques et tableaux figurent dans le texte de sa réponse, mais les images et fichiers créés par le code n'arrivent pas dans la réponse.

Qui peut faire quoi¶

Voir les outils dans la Salle des machines : quiconque peut modifier la toolbox, c'est-à-dire les administrateurs de l'organisation et un rôle à vous qui a le droit de modifier la toolbox.
Donner les outils à un assistant : quiconque peut modifier cet assistant.
Les utiliser : toute personne autorisée à chatter avec l'assistant. Une règle qui interdit ces outils à quelqu'un s'applique aussi quand cette personne chatte avec l'assistant.

Où trouver les outils¶

Les trois outils sont réservés aux assistants : une personne ne peut pas les utiliser elle-même dans l'AI Toolbox. Ils font partie de la toolbox de chaque organisation, sans que personne ait à les activer d'abord. Vous les trouvez dans l'onglet Outils de chaque assistant, et dans la Salle des machines comme Assistants uniquement ; sous Pour qui, choisissez Assistants uniquement pour ne voir que ces outils. Ils n'ont pas d'interrupteur Aussi pour les personnes, car une personne ne peut pas les utiliser.

Vous pouvez les mettre dans un groupe dans la Salle des machines pour les garder ensemble ; dans l'onglet Outils d'un assistant, vous activez chacun séparément.

Donner les outils à un assistant¶

Ouvrez les paramètres de l'assistant et choisissez l'onglet Outils.
Cherchez ordinateur ou code et choisissez Activer pour Exécuter du code, Écrire un fichier sur l'ordinateur et Lire ou exporter un fichier de l'ordinateur. Chaque choix enregistre aussitôt une nouvelle version de l'assistant.
Vérifiez dans l'onglet Paramètres que Ajouter des pièces jointes aux messages de chat est activé ; sinon personne ne peut envoyer de fichiers à l'assistant.

Un employé virtuel de l'assistant peut utiliser les mêmes outils pour les fichiers que reçoit son exécution.

Deux avis dans l'onglet Outils¶

L'un de ces avis peut apparaître au-dessus des outils. L'enregistrement reste possible ; ils indiquent seulement ce que l'assistant ne peut alors pas faire.

L'assistant peut exécuter du code, mais pas rendre de fichiers. L'assistant a Exécuter du code sans Lire ou exporter un fichier de l'ordinateur. Choisissez le bouton de l'avis pour activer cet outil.
Personne ne peut envoyer de fichiers à cet assistant. Ajouter des pièces jointes aux messages de chat est désactivé. Choisissez Aller aux paramètres et activez-le, sauf si l'assistant doit seulement calculer avec ce qui figure dans la conversation.

Quand les outils sont indisponibles¶

Si votre organisation ne peut pas exécuter de code, les trois outils apparaissent grisés dans l'onglet Outils, avec indisponible au lieu de Activer, et une ligne qui dit pourquoi :

Ligne	Ce qu'elle signifie	À qui demander
Indisponible : votre organisation ne peut pas exécuter de code.	Les ordinateurs ne sont pas autorisés pour votre organisation.	Les administrateurs de l'organisation au-dessus de la vôtre, ou Artific s'il n'y en a pas.
Indisponible : cette installation d'Artific Core ne fait tourner aucun ordinateur.	L'installation sur laquelle OS fonctionne pour votre organisation n'a pas d'ordinateurs.	Artific.

La même raison figure dans Paramètres de l'organisation, dans l'avis indiquant que votre organisation ne crée pas de fichiers Word, Excel ou PowerPoint, avec la date du dernier essai d'OS. OS vérifie à nouveau chaque jour. Une fois les ordinateurs autorisés, vous pouvez activer les outils tout de suite ; il peut falloir jusqu'à environ un jour avant qu'ils fonctionnent dans le chat.

Si votre organisation perd les ordinateurs alors qu'un assistant a déjà les outils, ils restent activés et la carte indique Ne fonctionne pas actuellement : votre organisation ne peut plus exécuter de code. Le chat indique pourquoi. Désactiver fonctionne toujours. Quiconque essaie d'activer un outil alors que ce n'est pas possible reçoit Exécuter du code est indisponible : votre organisation ne peut pas exécuter de code.

Ce que cela coûte¶

Une réponse dans laquelle l'assistant a exécuté du code consomme, en plus des tokens du modèle, du temps de calcul : les secondes pendant lesquelles son ordinateur a tourné. Ce temps compte dans la consommation de votre organisation et dans son budget mensuel, comme toute consommation. Une réponse sans code ne consomme pas de temps de calcul. OS n'affiche pas encore le temps de calcul : ni dans le chat, ni sur une page dédiée.

Ce qui est enregistré¶

L'activation figure dans le journal d'audit de votre organisation, comme une modification de l'assistant, avec la version qu'elle a écrite.
Chaque ordinateur est enregistré par Artific Core : quand il a été créé et quand il a disparu, combien de temps il a tourné, et pour chaque étape de quel type elle était, combien de temps elle a duré et avec quel code de sortie. Les commandes elles-mêmes, leur sortie et les noms de fichiers n'y figurent pas ; ils ne se trouvent que dans le chat et dans l'onglet Journaux de session de l'assistant. OS n'enregistre rien par réponse, pour que rien ne figure deux fois.

Données et réseau¶

L'ordinateur n'a pas accès à internet, et OS ne l'active jamais. Le code écrit par le modèle ne peut donc envoyer un fichier nulle part, quoi que dise une cellule. Un fichier du chat est copié sur un ordinateur dans la région où votre organisation reçoit ses ordinateurs ; si votre politique n'autorise pas cette région, chaque étape est refusée et le chat l'indique.

Par l'API¶

GET /api/v1/organisations/{id}/assistants/tool-choices renvoie unavailable pour chacun des trois outils : null, not_permitted ou no_computers.
Un enregistrement de l'assistant qui ajoute l'un des trois alors que votre organisation ne peut pas exécuter de code reçoit 422 ; le champ type de l'erreur en donne la raison.
GET /api/v1/organisations/{id}/toolbox/elements?offered_to=agents inclut les trois outils, avec fixed: false, pour quiconque peut modifier la toolbox.