Quelle expérience utilisez-vous ?
Cette documentation couvre les deux expériences. Si Settings → Personal → My Okou est disponible, suivez les étapes My Okou. Si vous utilisez une page Agents avec New agent, suivez les étapes Legacy Agents. La disponibilité peut varier selon les membres ; cette documentation ne modifie pas votre expérience.
Dans les deux expériences, vous pouvez lancer plusieurs chats ou tâches à la fois, réutiliser des workflows et partager avec votre équipe le travail relu. Un sous-agent d’exécution est un outil d’exécution, pas un profil produit distinct que vous devez créer.
Différences de configuration : My Okou utilise des instructions personnelles (Instructions) dans Settings → Personal → My Okou et des workflows de l’espace de travail. Toute étape ci-dessous qui vous demande de choisir, créer ou autoriser un agent nommé s’applique uniquement aux Legacy Agents. Dans My Okou, utilisez votre propre chat et suivez la demande de compte et d’autorisation nommée affichée. Les workflows partagés ne partagent pas les identifiants ; les automatisations utilisent le contexte et l’accès de leur propriétaire.
Un chat est un fil de conversation. Chaque message qui demande à Okou d’agir démarre une exécution dans ce fil. Répondre dans le même chat conserve disponibles comme contexte les messages et artefacts précédents du fil ; ouvrir un nouveau chat démarre un contexte séparé.
Pourquoi les chats comptent
- Le contexte est limité au fil. Une exécution peut utiliser les messages et les artefacts de son propre chat. Elle ne lit pas automatiquement l’historique d’un autre chat.
- Les exécutions sont inspectables. Le fil affiche les messages, l’activité des outils, les artefacts, l’état et les erreurs produits par ses exécutions.
- Le travail peut être redirigé pendant son exécution. Vous pouvez arrêter une exécution active, ou envoyer une correction pendant qu’Okou travaille encore — la nouvelle instruction est prise en compte dans l’exécution active au lieu d’abandonner le travail déjà en cours. Les messages consécutifs restent groupés comme une seule rafale dans le fil. Pour répondre à une phrase exacte, sélectionnez-la et choisissez Quote pour insérer ce texte dans votre prochain message.
Comment les chats et les exécutions démarrent
- Ouvrir une nouvelle conversation dans l’application web crée un nouveau fil de chat.
- Envoyer une autre tâche dans cette conversation lance une autre exécution dans le même fil.
- Une conversation Slack conserve le contexte dans son fil Slack associé.
- Une automatisation s’exécute dans le chat d’automatisation associé à son workflow et à son propriétaire. Les déclenchements répétés de ce workflow réutilisent ce chat d’automatisation.
Plusieurs fils peuvent s’exécuter en même temps. Des fils de chat différents avancent indépendamment — lancez une étude de marché dans l’un, rédigez une publication dans un autre, et les deux progressent simultanément. Le nombre d’exécutions parallèles dépend de votre forfait ; voir Crédits et facturation. Quand tous les emplacements d’exécution sont occupés, la prochaine exécution attend qu’un emplacement se libère.
Dans un même fil, les exécutions sont séquentielles. Un fil effectue une seule exécution à la fois. Une correction que vous envoyez pendant qu’une exécution travaille rejoint cette exécution au lieu d’en démarrer une deuxième en parallèle.
Où une run s’exécute
Chaque exécution obtient sa propre machine — une vraie, avec un terminal, un système de fichiers et un navigateur. C’est ce qui permet à Okou d’exécuter réellement la transformation du tableur, de cloner le dépôt ou de rendre la présentation, au lieu d’expliquer comment vous le feriez.
Cet environnement est privé pour l’exécution et est détruit lorsque l’exécution se termine. Le code qui s’exécute à l’intérieur ne reçoit jamais les identifiants de vos connecteurs — ils sont injectés à la frontière réseau — et chaque requête effectuée par l’exécution est enregistrée. Voir Security pour savoir comment l’isolation est construite.
Considérez la machine comme temporaire. Tout ce qu’il vaut la peine de conserver doit se retrouver dans un emplacement durable : publié en tant que page, déposé dans un outil connecté ou téléchargé. Un chemin de fichier sur la machine de l’exécution n’est pas quelque chose que vous pouvez partager.
Continuer ou repartir de zéro
Continuez dans le même fil lorsque la prochaine demande dépend de messages, de fichiers ou de décisions antérieurs. Ouvrez un nouveau fil lorsque vous voulez un contexte indépendant.
Les canaux sont des points d’entrée vers le même espace de travail, mais ils ne créent pas un historique de conversation global unique. Un nouveau fil web, Slack, Telegram ou téléphone n’importe pas automatiquement les messages d’un autre fil. Lorsque vous déplacez le travail vers un nouveau fil, incluez le contexte ou l’artefact dont il a besoin.
Inspecter une run
Utilisez l’activité du fil ou son contrôle de journal pour inspecter l’exécution. Il enregistre la séquence visible des messages, l’activité des outils, les artefacts, les changements d’état et les erreurs. C’est le premier endroit à vérifier lorsqu’un résultat est incomplet ou qu’une action de connecteur n’a pas eu lieu.
Dépannage
| Ce que vous voyez | Ce qu’il faut vérifier ou faire |
|---|---|
| Queued | L’espace de travail n’a aucun emplacement d’exécution libre, donc l’exécution n’a pas encore commencé. Attendez qu’un emplacement se libère ; un message en file d’attente peut être supprimé avant son démarrage. Envoyer une correction dans une exécution déjà en cours ne met pas le message en file d’attente — ce message rejoint l’exécution active. |
| Une carte Connect ou Authorize | Le compte requis n’est pas connecté, ou cet agent n’a pas l’autorisation de connecteur requise. Complétez la carte et choisissez uniquement l’accès et la durée dont la tâche a besoin. Si l’exécution ne reprend pas, réessayez la demande dans le même fil. |
| Selected model is not available | Le modèle du fil n’est pas actuellement utilisable selon la politique de modèles de l’espace de travail ou la connexion au fournisseur. Choisissez un modèle disponible dans le composeur, ou reconnectez le fournisseur demandé sous Settings → Models. |
| Insufficient credits | L’espace de travail ne peut pas lancer davantage de travail de modèle avec son solde actuel. Ouvrez Billing pour vérifier le solde, recharger ou changer de forfait, puis réessayez. |
| Une erreur de téléversement de pièce jointe | Le fichier n’a pas fini de se téléverser, donc il n’est pas disponible pour l’exécution. Réessayez le téléversement avant d’envoyer à nouveau le message. |
| Une exécution est Failed | L’exécution s’est terminée sans résultat. Ouvrez son erreur visible et son journal d’activité, corrigez le problème de connecteur, d’autorisation, de modèle, d’entrée ou de service signalé, puis réessayez. |
Lorsque vous demandez de l’aide au support, partagez l’URL du chat et l’erreur visible de l’exécution en échec. Ne collez jamais de secrets de connecteur ni de clés de fournisseur dans le chat.
Et ensuite
- Voir Autorisations pour ce qui est appliqué à la frontière du chat.
- Voir Crédits et facturation pour savoir comment le coût du chat est calculé.
- Voir Automatisations pour le modèle de chat récurrent et déclenché par des événements.
