Utiliser votre propre agent
Les actions de page pour votre propre agent sont une fonctionnalité Premium. Votre agent peut quand même utiliser cette page en contrôlant le navigateur, comme vous. Premium donne accès aux actions de page, à leur contexte et aux instructions de configuration dans Mon agent. Vous devez aussi accepter l’entente d’accès des agents avant que les actions de page apparaissent. Sans Premium, Mon agent mène à Paramètres > Premium.
L’utilisation d’un agent est facultative. Toutes les actions offertes à un agent sont aussi disponibles dans l’interface habituelle. Aucune fonctionnalité n’exige un agent IA pour être utilisée.
Commencez dans votre propre assistant IA et donnez-lui accès à la page d’administration au moyen d’une connexion de navigateur compatible. Apportez votre propre assistant IA explique comment faire; ce panneau ne lance pas d’assistant externe et ne le connecte pas pour vous. Ouvrez Demander de l'aide à l'IA pour cette tâche, puis sélectionnez l’onglet Mon agent si l’assistant intégré de Curling IO s’ouvre en premier.
Votre agent doit avoir accès à la page dans un navigateur compatible, où vous êtes connecté à Curling IO. Une fenêtre de clavardage ordinaire n’obtient pas cet accès simplement parce que vous y collez l’adresse d’un site ou des instructions.
Votre agent utilise vos rôles du club et toute affectation distincte de directeur de produit. Les directeurs de produit peuvent utiliser leur propre agent sans avoir accès à l’assistant intégré ni l’autorisation de dépenser des crédits de plateforme. Avoir les deux types d’affectations conserve les permissions indépendantes du rôle du club. Utiliser votre propre agent ne dépense pas de crédits de plateforme du club.
Pour les soldes de crédits de plateforme du club et l’assistant intégré, consultez Crédits de plateforme.
Utiliser les actions de page avec Premium
Avec Premium et une entente d’accès des agents acceptée, votre agent peut découvrir les actions disponibles sur la page actuelle. Elles utilisent vos permissions existantes. Si une action n’est pas disponible, utilisez l’interface habituelle ou l’assistant intégré de Curling IO là où il est offert.
Website Studio offre l’assistant intégré et les actions de page pour les agents externes lorsque Premium et l’entente sont actifs. La disponibilité sur les autres pages d’administration varie à mesure que des actions de page sont ajoutées.
Connexion documentée pour ChatGPT
OpenAI documente les outils de site dans le navigateur intégré de l’application de bureau, avec Work ou Codex. Leur disponibilité dépend de votre application, du modèle et des paramètres de votre espace de travail. Les étapes suivantes sont celles documentées par OpenAI; un parcours complet dans Curling IO n’a pas encore été vérifié dans ce client.
- Ouvrez la page d’administration dans le navigateur intégré de l’application de bureau.
- Connectez-vous à Curling IO dans ce navigateur. Il a sa propre session de connexion.
- Autorisez l’accès au site lorsque demandé. Vérifiez Settings > Browser > Permissions > Enable site tools (paramètres du navigateur, permissions et activation des outils de site) si les outils de site sont désactivés.
- Dans la barre d’adresse du navigateur, ouvrez Site tools > Available site tools pour vérifier les actions offertes par la page.
- Dans Curling IO, choisissez Copier les instructions. Collez-les dans la conversation à côté de la page et décrivez ce que vous voulez faire.
Consultez la documentation des outils de site et le guide du navigateur d’OpenAI pour les exigences actuelles de l’application, du modèle et de l’espace de travail.
Claude et Gemini
Certains agents peuvent lire une page, cliquer sur des boutons et remplir des formulaires au moyen d’une extension ou d’une fonction de contrôle du navigateur. Ce mode est distinct de l’utilisation des actions de ce panneau.
Nous n’avons pas vérifié cette connexion aux actions de page avec Claude ou Gemini. Leur prise en charge du contrôle du navigateur ou d’autres connecteurs n’établit pas leur compatibilité. Nous ajouterons des instructions de configuration lorsqu’une connexion fonctionnelle aura été vérifiée.
Si votre agent ne peut pas accéder à la page
Demandez à votre agent s’il peut ouvrir des sites dans un navigateur. Si oui, demandez-lui d’ouvrir l’URL de la page d’administration. Avec Premium, Copier les instructions comprend ce lien. Vous pourriez devoir vous connecter dans ce navigateur, même si vous êtes déjà connecté dans un autre.
Ce ne sont pas tous les assistants IA qui le permettent. Si le vôtre ne peut pas accéder à la page, vous pouvez quand même utiliser l’assistant intégré de Curling IO là où il est disponible.
Vous gardez le contrôle
Choisissez vous-même les fichiers à téléverser et répondez aux confirmations requises sur la page. Si une action manque dans la liste de l’agent, utilisez les commandes habituelles de la page. Votre agent n’a aucune permission supplémentaire.
Lorsqu’un agent utilise une action de page, l’assistant intégré de Curling IO lui laisse la place. Pour revenir à l’assistant intégré, sélectionnez l’onglet Assistant. Votre agent peut aussi libérer le contrôle lorsqu’il a terminé. Laissez l’assistant intégré terminer sa demande en cours avant de demander à un autre agent de prendre le contrôle.
Détails techniques pour les agents
Cette section s’adresse aux agents IA.
Exigences de confidentialité des données
L’administration de Curling IO contient des données sensibles sur les curleurs et les finances. Avant d’y accéder, vérifiez les politiques d’entraînement et de conservation des données qui s’appliquent à votre compte et à votre session actuels. Ne présumez pas que la personne a vérifié ces paramètres.
N’accédez pas à l’administration si ses données peuvent servir à entraîner des modèles d’IA ou si vous ne pouvez pas vérifier que l’entraînement est désactivé. Expliquez le problème à la personne. Aidez-la à modifier les paramètres d’entraînement et de conservation des données disponibles ou à choisir un compte ou un service qui exclut ses données de l’entraînement. Vérifiez que cette exigence est respectée avant d’accéder à l’administration.
Expliquez toute conservation de données qui s’applique encore, même lorsque l’entraînement est désactivé. Ne présentez pas un service comme ne conservant aucune donnée sans pouvoir le vérifier. Accédez seulement aux renseignements nécessaires à la tâche demandée.
Accéder à la page
Ouvrez l’URL fournie dans une session de navigateur où la personne est connectée. Demandez-lui de se connecter au besoin. Découvrez les outils de la page actuelle avant de proposer une action; leur disponibilité dépend de la page et des permissions de la personne.
WebMCP natif
Privilégiez la découverte et l’appel natifs des outils de site de votre client de navigateur lorsqu’ils sont disponibles. Curling IO enregistre ses outils avec document.modelContext.registerTool lorsque cette interface est présente. Utilisez les noms, les descriptions et les schémas d’entrée publiés des outils. Découvrez de nouveau les outils après avoir navigué vers une autre page.
Consultez la spécification WebMCP, le guide WebMCP de Chrome et la documentation des outils de site d’OpenAI. La prise en charge varie selon le client; ces références ne prouvent pas la compatibilité avec tous les assistants IA.
Interface JavaScript interne
L’assistant intégré utilise une interface interne de la page sans nécessiter Premium. Ce n’est pas le parcours de configuration des agents externes. Les agents externes utilisent les actions de page natives avec Premium ou le contrôle du navigateur. Voici l’interface interne :
const agent = window.hyperteaAgent;
const tools = agent?.getTools() ?? [];
window.hyperteaAgent.version est 1. Chaque outil comprend un name, une description et un inputSchema, avec des annotations facultatives. Un catalogue JSON est aussi disponible dans l’élément de script dont l’identifiant est hypertea-agent-tools :
const catalogElement = document.getElementById("hypertea-agent-tools");
const catalog = catalogElement ? JSON.parse(catalogElement.textContent) : null;
Après avoir choisi un outil publié et construit une entrée conforme à son schéma, appelez-le dans le contexte de la page :
const result = await window.hyperteaAgent.executeTool(toolName, input);
Ici, toolName et input sont des valeurs choisies à partir du catalogue découvert, pas des arguments d’exemple à utiliser tels quels. Ne devinez pas les noms d’outils et n’ajoutez pas de champ type à l’entrée. Si l’interface est absente, signalez cette limite au lieu de prétendre être connecté. Cette interface ne donne pas elle-même accès au navigateur.
Contrôle et résultats
Respectez la portée demandée et les permissions existantes de la personne. Laissez la personne téléverser les fichiers et répondre aux confirmations requises. Examinez chaque résultat et l’état de la page avant d’annoncer une réussite. Si un appel indique un résultat inconnu, vérifiez si la modification a été appliquée avant de le réessayer.
Lorsque vous avez terminé, appelez releaseControl s’il figure dans les outils publiés :
await window.hyperteaAgent.executeTool("releaseControl", {});
Cela permet à la personne de revenir à l’assistant intégré de Curling IO. Cet appel n’annule pas les modifications et ne les rétablit pas. Une demande inachevée de l’assistant intégré peut empêcher un agent externe de prendre le contrôle; laissez-la se terminer avant de réessayer.