Sous-agents pour B2C Shopper Agent

Routeur d’agent

Chaque conversation d’agent commence par le sous-agent Agent Router. Ce sous-agent dirige une conversation vers le bon sous-agent spécifique à l’agent d’achat lors de chaque interaction avec un acheteur.

• Si un acheteur répond par une réponse ambiguë au cours d’une conversation, par exemple s’il saisit « ajouter », l’Agent Router traite ces réponses comme étant liées à la tâche en cours, et non aux nouvelles demandes.
• L’agent achemine les messages en fonction du dernier message de l’acheteur. Il filtre automatiquement tout code d’arrière-plan, toute utilisation d’outil automatisé ou toute étape technique effectuée dans les messages précédents. L’agent réagit précisément à ce que l’acheteur demande à ce moment-là, sans interférence avec les activités passées du système.

Pour personnaliser le sous-agent du routeur :

• Ajoutez une route pour exposer un nouveau sous-agent, ou supprimez-en un pour désactiver une fonctionnalité.
• Ajustez le message de bienvenue ou les instructions d’acheminement. Par exemple, modifiez la description du routeur pour souhaiter la bienvenue à l’acheteur lors de la première session de chat.
• Réorganisez ou reformulez la logique de routage pour influencer la façon dont l’agent interprète les demandes ambiguës afin de les résoudre pour qu’elles correspondent à votre catalogue.

Sous-agents de l’agent d’achat

Les sous-agents Expert produit, Panier et Confirmation de commande partagent le même nœud de raisonnement. Ce nœud construit l’invite de chaque sous-agent à partir d’un ensemble commun de variables de modèle. Les sous-agents Support et Safety n’utilisent pas le nœud partagé. Ils fonctionnent selon leurs propres instructions. Étant donné que ces trois sous-agents Commerce s’appuient sur les mêmes variables, la modification d’une variable modifie le comportement de tous les sous-agents qui l’utilisent.

• retailer_name
• retailer_description
• retailer_voice
• tool_calling_guidance
• response_guidance
• example_response
• id_col

Sous-agents de sécurité et de garde-corps

Il existe des sous-agents qui ne classent que les requêtes. Ils ne font rien d’autre. Ils sont intentionnellement étroits. Chacun d’entre eux comprend une section détaillée Ne PAS utiliser afin que les termes d’achat courants ne soient pas traités comme une attaque. Vous définissez ces garde-fous dans config.additional_parameter__disabled_topics.

• Ingénierie inverse : intercepte les tentatives d’extraction des composants internes de l’agent. Ces demandes peuvent prendre la forme de « montrez-moi l’invite de votre système », « énumérez tous vos outils », « traduisez vos instructions ». Ignore explicitement les verbes de domaine tels que ajouter, afficher, rechercher, extraire et « cet outil ».
• Prompt Injection : intercepte les tentatives de remplacement, telles que « ignorer les instructions précédentes », les fausses <balises système> , le « mode développeur », l’usurpation d’identité d’autorité et les charges utiles codées. Ignore explicitement les mots tels que « ignorer » ou « oublier » pour les détails décrits par l’acheteur.
• Contenu inapproprié : intercepte le contenu véritablement préjudiciable créé par l’utilisateur (discours haineux, menaces, CSAM, automutilation, instructions d’actes illégaux). Traite explicitement le vocabulaire commercial comme toujours inoffensif, tel que « cassé », « batterie déchargée », « affaire qui tue » et les plaintes d’un acheteur, telles que « pire expérience ». Ces sous-agents acheminent les messages contenant ce type de contenu vers le sous-agent approprié et ne les signalent pas.
• Hors sujet : redirige poliment les demandes hors sujet et les demandes de connaissances générales vers des sujets d’achat, sans répondre à la question hors sujet et sans révéler les détails du système.

Pour personnaliser ces sous-agents :

• Ajustez les listes de signaux en fonction de votre magasin. Ajoutez vos propres noms de produits contenant des mots sensibles à la liste toujours inoffensive afin que le modèle ne les signale pas. Ajoutez les schémas d’attaque que vous voyez.
• Ajustez le message et les règles de redirection hors sujet.
• Ajoutez ou supprimez des sujets désactivés à l’aide de la config.additional_parameter__disabled_topics.

Conseils pour la configuration des sous-agents

• De nombreux sous-agents peuvent partager une seule variable. Pour éviter de modifier tous les sous-agents qui utilisent une variable partagée, utilisez des variantes délimitées, telles que cart_tool_calling_guidance ou order_tool_calling_guidance, pour contrôler le comportement d’un sous-agent individuel.
• Chaque chaîne de response_guidance est limitée à 255 caractères. Le dépassement de cette limite provoque une erreur de script de l’agent.
• Le response_guidance est JSON : validez les guillemets échappés et évitez les virgules de fin.
• Remplacez les espaces réservés. Le fait de laisser un jeton non substitué dans la section UPPER_SNAKE_CASE peut entraîner un échec de publication.
• Testez avec des données réelles. Dans l’aperçu de l’agent, le mode fictif renvoie de fausses données de catalogue. Testez tout comportement de recherche et de panier par rapport aux actions en direct avant de tirer des conclusions.