Référence des outils de l’agent

exec_command

Exécute une commande shell dans le workspace d’exécution. command contient la commande complète ; fichiers et dépendances appartiennent à cet environnement.

install_packages

Installe des dépendances dans le workspace avec un gestionnaire et une liste de paquets. Cet outil n’installe rien sur votre ordinateur personnel.

list_files

Liste un dossier du workspace. path permet d’examiner son contenu avant de modifier des fichiers.

read_file

Lit un fichier du workspace par son chemin, notamment pour connaître son contenu avant modification.

write_file

Crée ou remplace le contenu d’un fichier du workspace. Un fichier existant est écrasé ; edit_file permet une modification ciblée.

edit_file

Remplace exactement old_text par new_text dans un fichier UTF-8. Il faut le lire d’abord ; une seule correspondance est exigée sauf avec replace_all. Un texte de remplacement vide supprime la correspondance.

delete_file

Supprime le fichier désigné par path, à votre demande. Vérifiez son contenu et ses consommateurs avant de supprimer des données persistantes.

wget

Télécharge directement un fichier distant vers un chemin du workspace. Utile pour conserver un document ou une archive originale sans recopier son contenu dans le chat.

workspace_history

Liste les changements de fichiers enregistrés et leurs identifiants de commit. limit contrôle le nombre d’entrées.

workspace_restore

Restaure un chemin depuis un commit trouvé avec workspace_history. La restauration devient un nouveau changement ; elle ne restaure ni la base ni les volumes Docker.

widget

Crée, modifie, liste ou supprime des widgets. content contient leur HTML autonome ; resources relie leurs dépendances backend. Les actions de partage publient, consultent ou copient les widgets du groupe ; description présente une publication.

resources

Examine les dépendances, relie les ressources dédiées à un widget et prépare un nettoyage. Utilisez les IDs retournés. cleanup reste un aperçu sauf avec dry_run=false ; l’application exige votre demande explicite. Les consommateurs partagés protègent les ressources.

docker_run

Démarre un service avec image, name et son port interne ; purpose décrit son usage. Le mode Docker et les permissions déterminent où il tourne. Utile pour un véritable service derrière un widget.

docker_manage

Liste les conteneurs, consulte leurs logs, y exécute une commande ou arrête un service géré. Indiquez action et son nom ; arrêter un service n’efface pas toutes ses données persistantes.

docker_compose

Pilote une application multiservice depuis un fichier Compose écrit dans le workspace. file le désigne ; action choisit démarrage, arrêt, inspection ou exécution. Examinez séparément ses volumes persistants.

register_tool

Enregistre un outil backend Python réutilisable depuis code et ses métadonnées TOOL. Ses paramètres deviennent utilisables par l’agent et les widgets. Placez les identifiants dans les secrets, pas dans le script.

list_tools

Liste les outils personnalisés et leurs indications d’usage avant réutilisation ou modification. Ce n’est pas le catalogue des outils natifs de cette page.

Aucun paramètre.

show_in_editor

Ouvre un fichier texte du workspace dans l’éditeur de fichiers Prism. Cet éditeur est distinct des formulaires Notes, mail, tâches et événements pilotés par editor.

http_request

Envoie une requête HTTP avec méthode, URL, en-têtes et corps facultatifs. Utile pour une réponse API ; utilisez wget pour conserver un fichier distant sans modification.

web_search

Recherche query sur le Web. Les résultats aident à trouver les sources ; ils ne remplacent pas la lecture de la page pertinente.

deep_research

Étudie question en plusieurs tours de recherche. max_rounds borne cette démarche ; une recherche étendue prend davantage de temps et d’appels modèle/outils.

browser_get

Ouvre une URL dans le navigateur côté serveur et examine la page rendue. Un script facultatif peut inspecter son état ; ce n’est pas votre navigateur personnel déjà connecté.

browser_act

Interagit avec une page via une liste d’actions navigateur. Utile pour formulaires, clics et vérifications d’interface. L’authentification et les hôtes accessibles dépendent de cet environnement.

add_attachment

Joint un fichier existant du workspace à la conversation pour le télécharger. path doit désigner le fichier terminé.

editor

Ouvre, lit ou modifie une note, un compositeur mail, une tâche ou un événement. Lisez sa révision avant modification, texte non enregistré compris. Les notes sont enregistrées immédiatement ; les autres formulaires attendent validation/envoi. Cet outil n’envoie jamais de mail.

email

Connecte, lit, recherche, envoie et organise mails, dossiers et règles. Les UIDs appartiennent à un dossier ; utilisez les IDs et noms exacts retournés. password_secret fournit les identifiants ; rule_preview permet de vérifier une règle avant application.

note

Crée, liste, modifie, supprime ou partage des notes Markdown. Un champ omis est conservé ; un corps vide l’efface. Pour la note ouverte, editor tient compte de l’état non enregistré.

task

Crée, filtre, modifie, termine, rouvre ou supprime les tâches personnelles. Utilisez un ID obtenu par list ; due et priority règlent échéance et urgence. Les automatisations programmées sont distinctes.

calendar

Liste, crée, modifie ou supprime des événements sur la source active. start/end et all_day définissent les dates ; la fin d’un événement journée entière est exclusive.

pim_source

Examine ou change les sources calendrier, tâches et Notes. CalDAV et Todoist utilisent des noms de secrets et testent la connexion ; le consentement Google/Microsoft reste dans le navigateur. Le chemin du vault est interne au conteneur serveur.

rag_search

Recherche par sens dans une collection nommée avec query et une limite facultative. La description aide à choisir les documents pertinents ; les sources retournées permettent de citer.

rag_ingest

Indexe un fichier du workspace via source_path, ou un texte content, dans collection. Un fichier par appel ; des embeddings configurés sont nécessaires.

rag_manage

Liste collections/documents, décrit une collection ou supprime le contenu choisi. La description explique quand rechercher. Les changements en mode partagé exigent les droits d’administration du groupe.

save_user_info

Mémorise un fait utilisateur dans topic et content, par exemple une préférence. C’est une mémoire personnelle, pas une collection documentaire.

save_learning

Enregistre un fait ou enseignement utile avec titre et contenu pour le retrouver. skill sert aux procédures structurées réutilisables.

search_history

Retrouve de l’historique enregistré pertinent avec query et une limite facultative. Les résultats sont bornés et ne reconstruisent pas des détails jamais enregistrés.

skill

Enregistre, retrouve, modifie ou supprime une procédure réutilisable. name, description, when_to_use et body expliquent quand et comment l’appliquer. Une Skill guide les outils ; elle n’accorde pas de nouvelles permissions.

cron

Crée, liste, modifie, suspend ou supprime une commande planifiée du workspace. schedule est une expression cron ; command s’exécute dans le workspace et description indique son rôle. Les nouveaux jobs utilisent le fuseau utilisateur applicable.

webhook

Crée ou gère un déclencheur HTTP entrant de l’agent. prompt peut contenir {{content}} ; session choisit la conversation et respond attend sa réponse. Gardez URL/jeton privés.

notify

Affiche une notification avec message, titre, niveau et délai facultatifs. Une notification locale ne prouve pas la réception d’un mail ou message externe.

subagent

Délègue une tâche indépendante bornée, consulte son état, attend ou annule. Les assistants partagent modèle, workspace, permissions et budget de tâche ; ils ne peuvent pas déléguer à leur tour. Le parent rassemble les résultats.

mcp

Liste, connecte, actualise, active ou retire des serveurs MCP. auth_secret désigne un secret Bearer enregistré. En mode partagé, un administrateur de groupe intervient ; une nouvelle autorisation OAuth exige le navigateur.

request_secret

Ouvre un formulaire sécurisé avec name et description. La valeur est enregistrée sans être collée dans le chat ; les outils suivants utilisent son nom.

secrets

Liste les noms de secrets, en supprime un à votre demande ou partage un secret personnel avec un groupe autorisé. La liste ne retourne pas les valeurs au modèle.

channel

Examine les canaux, connecte un bot Telegram via token_secret ou dissocie son chat. Slack et Webex de groupe se configurent dans leurs écrans respectifs.

agent_settings

Lit/modifie le comportement personnel ou gère les sources IA et modèles autorisés. Les clés sont des noms de secrets ; réindexer exige votre accord. En mode partagé, les changements IA du déploiement sont réservés à l’administrateur global.

update_system_prompt

Change la personnalité de cet espace de dashboard. agent_settings règle la personnalité par défaut entre espaces. Aucun des deux ne remplace les règles d’accès.

prism_help

Lit l’aide embarquée par topic, ou retourne son index et l’état des connexions. Demandez à l’agent où se trouve un réglage ou comment utiliser une capacité.

place_call

Programme une mission téléphonique avec contact_name ou phone_number et une mission autonome. Seule cette mission est transmise à l’agent appelant ; la programmation ne prouve pas sa réussite.

list_calls

Examine les appels sortants prévus ou récents et leurs résumés. done signifie que l’appel est terminé, pas nécessairement que son objectif est atteint.

Aucun paramètre.

cancel_call

Annule un appel sortant encore en attente via call_id retourné par list_calls. Un appel dont la numérotation a commencé ne peut plus être annulé ainsi.