Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Agents personnalisés
L'agent personnalisé est une action intelligente qui traite les entrées en langage naturel pour automatiser des étapes complexes à l'aide de fonctionnalités intégrées d'appel d'outils. Il utilise principalement les intégrations comme interface d'outil, tout en offrant une extensibilité permettant d'utiliser le code en tant qu'outil, et d'autres actions natives telles que la tâche humain-the-loop. L'agent fournit des résultats structurés et prévisibles optimisés pour une intégration parfaite dans les étapes d'automatisation en aval.
Propriétés
-
Titre : Nom de l' step/custom agent
-
Mode : un mode définit le mode de fonctionnement de l'agent en fonction de votre cas d'utilisation. Les trois modes disponibles sont les suivants : Rapide, Pro et Personnalisé. Fast est idéal pour les tâches simples telles que le résumé, la classification et les automatisations de gros volumes, tandis que Pro est idéal pour les tâches complexes impliquant le raisonnement et l'orchestration de plusieurs outils ou actions. Fast et Pro sont des modes entièrement gérés qui ne nécessitent aucune préconfiguration préalable. En mode personnalisé, vous aurez besoin d'un connecteur d'exécution Bedrock et pourrez sélectionner le modèle que vous souhaitez utiliser (expliqué ci-dessous). C'est idéal lorsque vous avez déjà une invite affinée pour un modèle Bedrock en particulier, que vous avez spécifiquement besoin d'un modèle Bedrock particulier pour l'agent ou que vous souhaitez inclure votre propre modèle personnalisé ou affiné hébergé sur Bedrock. En mode personnalisé, puisque vous apportez votre propre modèle depuis Bedrock via une intégration, l'inférence du modèle est facturée séparément sur le compte associé à cette intégration Bedrock.
-
Instructions : Dans ce champ, vous écrivez l'invite pour l'agent en langage naturel. Bonnes pratiques lors de la rédaction de l'invite :
Soyez clair et explicite quant à ce que vous voulez.
Structurez l'invite. Commencez par mentionner la « tâche » ou le « rôle », puis les « instructions » pour réaliser la tâche avec des étapes numérotées
Pour améliorer la précision des appels d'outils et guider l'agent, spécifiez clairement dans l'invite l'outil à utiliser à chaque étape, le cas échéant.
Spécifiez clairement les exigences de longueur (par exemple, moins de 100 mots) ou le format de sortie (par exemple, date dans le MM/DD/YY format)
Mettez le texte entre guillemets (« ») pour écrire des instructions multilignes. Par exemple :
"""You are content summarization agent. Summarize the last two paragraphs of the provided text, focusing only on the main conclusion."""
-
Actions : L'action est un outil qui permet à l'agent IA d'interagir avec des systèmes externes ou d'effectuer des tâches spécifiques. Ce nom est facultatif. Vous pouvez exécuter l'agent personnalisé sans aucune action. Vous trouverez ci-dessous les différentes actions qui peuvent être utilisées dans l'agent personnalisé
-
Actions générales
Créer une tâche utilisateur : s'il est activé, cet outil permet à l'agent de déclencher une tâche Human-in-the-Loop (HITL) chaque fois qu'elle est bloquée et qu'elle a besoin d'assistance lors de son exécution. L'agent fait une pause et attend l'intervention humaine. La tâche HITL est visible dans le centre de tâches. Pour de meilleurs résultats, l'auteur peut spécifier dans l'invite exactement à quel moment l'agent doit invoquer HITL. Cette option est sélectionnée par défaut. L'automatisation s'exécute jusqu'à ce que la tâche soit terminée.
Code - L'action Code génère et exécute du code python dans un environnement Python restreint, comme les actions de code, pour résoudre des tâches impliquant des calculs, la manipulation de données et le traitement de fichiers. Contrairement aux générateurs de code, il crée et exécute activement des scripts pour atteindre des objectifs, en travaillant avec Excel, des fichiers PDF, divers formats de données et les intégrations disponibles
Capacités clés :
Opérations sur les fichiers : traiter des fichiers Excel à onglets multiples, extraire du contenu, effectuer des calculs de date, appliquer une mise en forme conditionnelle et télécharger les résultats dans S3
Transformation des données : conversion entre le format JSON et le format de table, transpose des données, renomme des colonnes et joint des tables
Calculs avancés : générez des séquences numériques et effectuez une validation automatique
-
Intégrations : si vous avez ajouté des actions d'intégration spécifiques, telles que Salesforce, MS Exchange ou Bedrock, à votre groupe d'automatisation, les actions correspondantes apparaissent ici pour être utilisées dans l'agent personnalisé. L'auteur peut ensuite sélectionner les actions pertinentes à utiliser comme outils pour l'agent.
Liste des intégrations pouvant être utilisées comme tools/actions dans l'agent personnalisé
Amazon S3
Amazon Bedrock Automatisation des données
Amazon Comprehend
Amazon Textract
API REST personnalisée
Connecteur MCP personnalisé
Microsoft Outlook
Salesforce
-
-
Sortie structurée (en option)
Configurez votre agent d'IA pour qu'il renvoie une sortie JSON structurée que les étapes en aval peuvent traiter. Cette fonctionnalité est idéale pour la synthèse de texte, la génération de rapports, la transformation des données et l'extraction de statistiques à partir de contenus non structurés. Il s'agit d'un champ facultatif. Si vous ne définissez pas de sortie structurée, l'agent renvoie la sortie en langage naturel par défaut. Utilisez une sortie structurée lorsque votre sortie possède une structure définie, telle qu'une liste, une table de données ou un fichier JSON.
Note
La configuration de sortie structurée pour les agents personnalisés suit le même format que les agents d'interface utilisateur. Reportez-vous à la section de sortie structurée de l'agent d'interface utilisateur pour obtenir des instructions de configuration détaillées.
-
Réponse de l'agent : nom de la variable à laquelle attribuer la sortie de l'agent. La réponse suit votre format de sortie structuré dans un schéma JSON s'il est défini, sinon il s'agit d'un texte de forme libre.
Utilisation de modèles personnalisés dans Custom Agent (apportez votre propre modèle de base)
Intégrez les modèles affinés de votre choix ou personnalisés hébergés dans AWS Bedrock avec les flux de travail d'automatisation de Quick Suite.
Avant de commencer, assurez-vous que vous disposez des éléments suivants :
Un modèle affiné déployé et accessible dans Bedrock AWS
Accès à Quick Suite Admin pour créer des connecteurs
Un rôle IAM avec des autorisations Bedrock pour invoquer des modèles
L'identifiant de votre modèle (par exemple,
us.anthropic.claude-3-5-sonnet-20241022-v2:0)
Étape 1 : Créez une intégration Bedrock Runtime Action en suivant les instructions détaillées dans AWS connecteurs d'action de maintenance
Étape 2 : configurer votre groupe d'automatisation
Créez un groupe d'automatisation et connectez l'intégration :
Créez un groupe d'automatisation - Suivez les instructions détaillées dans Tâches de configuration
Configuration des intégrations : suivez les instructions détaillées dans Tâches de configuration
Une fois configuré, le connecteur apparaît dans votre liste de ressources disponibles
Étape 3 : Configuration d'un agent personnalisé
Ajoutez et configurez un agent personnalisé pour utiliser votre modèle personnalisé :
Dans votre flux de travail d'automatisation, ajoutez un agent personnalisé
Configurez les paramètres d'agent suivants :
Titre de l'agent : entrez un nom descriptif pour votre agent
Instructions : entrez des instructions personnalisées adaptées à votre cas d'utilisation
Mode : Sélectionnez Personnalisé
Connecteur : Choisissez votre connecteur Bedrock Runtime (obligatoire lorsque le mode personnalisé est sélectionné)
Modèle personnalisé : entrez l'identifiant de votre modèle (par exemple,
us.anthropic.claude-3-5-sonnet-20241022-v2:0), obligatoire lorsque le mode personnalisé est sélectionné
Étapes suivantes
Une fois configuré, votre agent personnalisé utilise le modèle affiné pour traiter les demandes conformément aux instructions que vous avez fournies. Vous pouvez désormais intégrer cet agent dans vos flux de travail Quick Automate.
Note
Assurez-vous que l'identifiant de votre modèle est correctement formaté et correspond au modèle déployé dans votre compte AWS Bedrock. Vous pouvez trouver l'identifiant de votre modèle dans la console AWS Bedrock, sous vos modèles approvisionnés.
Tests d'agents personnalisés
Les tests d'agents personnalisés vous permettent de tester des agents individuels indépendamment de l'ensemble du flux de travail d'automatisation. Cette fonctionnalité vous permet de valider le comportement de l'agent, de déboguer les instructions et d'itérer plus efficacement sans exécuter l'intégralité du flux de travail.
Conditions préalables
Un flux de travail d'automatisation avec au moins un agent personnalisé configuré
Autorisations appropriées pour exécuter des automatisations dans votre espace de travail
Lancer un test
Dans le canevas du flux de travail, survolez la carte d'agent que vous souhaitez tester
Choisissez le bouton Test unitaire qui apparaît en haut de la carte
Dans la fenêtre de collecte de variables qui s'ouvre, passez en revue les variables détectées automatiquement à l'invite de votre agent
L'aperçu rapide affiche toutes les variables détectées avec surbrillance
Entrez une valeur pour chaque variable
Les valeurs doivent utiliser une syntaxe d'expression valide
Si une valeur contient une syntaxe non valide, un message d'erreur apparaît et empêche l'exécution du test
Surveiller l'exécution des tests
Pendant l'exécution du test, vous pouvez suivre la progression dans le panneau d'audit situé sur le côté droit de l'écran. Le test ignore toutes les étapes précédentes du flux de travail et n'exécute que l'agent sélectionné. Vous bénéficiez de la même expérience de journalisation qu'une exécution complète d'un flux de travail.
Passez en revue les résultats des tests
Une fois le test terminé, consultez les informations suivantes dans le panneau Test :
Carte de mesures (onglet Moniteur en haut du panneau de test)
Temps d'exécution total
Nombre d'outils utilisés
Nombre de tâches créées
Se connecte entre les deux
Afficher l'onglet Variables (accordéon inférieur du panneau de test)
Entrée - Afficher les variables d'entrée et leurs valeurs
Sortie : examine les résultats de sortie de l'exécution de l'agent
Pour les sorties structurées, cliquez sur le bouton Afficher les détails pour choisir le visualiseur JSON pour ouvrir la boîte de dialogue Afficher la sortie :
Onglet Champs - Parcourez les données à l'aide de la vue arborescente
Champs - Mettez en évidence les valeurs correspondantes en sélectionnant des nœuds d'arborescence dans l'onglet Champs
Champs de sortie - Valeurs correspondantes pour les clés JSON
Utilisation d'un agent personnalisé avec Build with Assistant
Le principe actuel de l'agent personnalisé est qu'il doit être spécifiquement mentionné pour qu'il soit régulièrement invoqué. Voici les éléments nécessaires dans l'invite pour le faire apparaître :
- Function names: `use_inline_agent` - Representation names: "Custom Agent", "Inline Agent" → use `use_inline_agent` - Generic terms: "agentic skills" → default to `use_inline_agent`
Dans le cas contraire, le modèle est préféré pour créer le flux de travail de manière déterministe.
Cependant, dans la pratique, lorsqu'aucune action appropriée n'est disponible, le planificateur peut choisir un agent personnalisé comme solution de contournement. Mais pour invoquer systématiquement un agent personnalisé dans le flux de travail, il est recommandé d'utiliser les phrases ci-dessus dans l'invite.
Exemples de cas d'utilisation d'agents
Cas d'utilisation 1 : agent de classification et d'attribution des e-mails
Rôle : Vous êtes un agent de catégorisation et d'attribution d'e-mails
Instructions : Procédez comme suit :
Étape 1 : Classer le courrier électronique entrant en fonction de la colonne Catégorie du tableau de référence fourni en tant que connaissance
Étape 2 : utilisez le système de messagerie pour envoyer une notification :
De : [system_email]
À : [team_distribution_email]
Sujet : [Résultat du classement]
Corps : inclure un bref résumé expliquant le raisonnement de classification et les points clés de l'e-mail d'origine
Étape 3 : Pour toutes les catégories valides (sauf « inconnue »), créez un nouveau dossier dans Salesforce avec :
Objet : [Objet de l'e-mail original]
Description : résumé du problème à partir du corps de l'e-mail
Priorité : basée sur l'urgence du contenu (High/Medium/Low)
Type : Sélectionnez le type approprié (Question/Problem/Feature Request/Other)
État : « Nouveau »
Catégorie : [Résultat du classement obtenu à l'étape 1]
Étape 4 : Si vous êtes classé comme « inconnu » :
Transférer au superviseur pour une révision manuelle
Ajouter une note expliquant pourquoi la classification était incertaine
En fonction de la catégorie reçue du superviseur, suivez les étapes 2 et 3 et arrêtez
Si la catégorie reçue du superviseur est inconnue ou non valide, arrêtez
Utilisation de bases de connaissances avec des agents personnalisés
Dans Amazon Quick Automate, vous pouvez connecter des bases de connaissances à des agents personnalisés pour permettre la AI-powered récupération des documents de votre organisation et la réponse à des questions. En liant un espace rapide à votre groupe d'automatisation, les agents personnalisés peuvent rechercher et récupérer des informations dans les bases de connaissances de cet espace.
Utilisez-le pour les automatisations qui doivent faire référence à des connaissances organisationnelles, telles que répondre à des questions issues de documents de politique, résumer des rapports ou classer le contenu en fonction de données de référence.
Les bases de connaissances indexent vos documents à des fins de recherche sémantique, de sorte que l'agent personnalisé ne récupère que les passages les plus pertinents au lieu de traiter des fichiers entiers. Cela permet une extraction plus rapide et plus précise, en particulier dans le cas de grands ensembles de documents.
Conditions préalables
Un espace rapide avec une ou plusieurs bases de connaissances configurées. Pour de plus amples informations, veuillez consulter Organisez, collaborez et partagez des ressources avec des espaces dans Amazon Quick.
Un groupe d'automatisation dont vous êtes propriétaire
Owner-level accès à l'espace que vous souhaitez lier
Associer un espace à votre groupe d'automatisation
Avant qu'un agent personnalisé puisse accéder aux bases de connaissances, vous devez lier l'espace contenant ces bases de connaissances à votre groupe d'automatisation. La liaison d'un espace autorise le groupe d'automatisation à accéder aux bases de connaissances et aux fichiers de cet espace.
Pour lier un espace à un groupe d'automatisation :
Dans l'onglet Automatisations, accédez à la page Projets.
Choisissez Groupes et sélectionnez le groupe auquel vous souhaitez associer l'espace.
Astuce
Vous pouvez également choisir Créer un groupe sur le côté droit pour créer un nouveau groupe d'automatisation.
Dans la section Ressources, choisissez Ajouter, puis Spaces.
Sélectionnez l'espace qui contient les bases de connaissances que vous souhaitez utiliser, puis choisissez Ajouter.
L'espace apparaît désormais dans la liste des connexions du groupe d'automatisation. Les agents personnalisés de ce groupe d'automatisation peuvent accéder aux bases de connaissances et aux fichiers de l'espace lié. Les autres ressources de l'espace ne sont pas disponibles pour les automatisations.
Note
Si l'espace indique « Accès limité » après avoir été ajouté, cela signifie que toutes les bases de connaissances ne sont pas partagées avec le groupe d'automatisation. Cela peut se produire si des bases de connaissances ont été ajoutées à l'espace après la liaison, ou si toutes les bases de connaissances n'ont pas été partagées initialement. Pour résoudre ce problème, actualisez la connexion à l'espace afin de partager toutes les ressources avec le groupe d'automatisation. Il n'est pas nécessaire de reconfigurer l'onglet Knowledge sur les agents personnalisés individuels.
Ajoutez des connaissances à un agent personnalisé
Après avoir lié un espace à votre groupe d'automatisation, vous pouvez configurer un agent personnalisé pour utiliser les bases de connaissances de cet espace. Le flux de travail doit se trouver dans le même groupe d'automatisation que celui dans lequel vous avez attaché l'espace.
Pour ajouter des connaissances à un agent personnalisé :
Dans le générateur de flux de travail, ajoutez une étape d'agent personnalisé. Vous pouvez soit glisser-déposer un nœud d'agent personnalisé sur le canevas, soit discuter avec l'assistant d'automatisation pour créer cette étape.
Dans le panneau des propriétés de l'agent, choisissez Knowledge, puis sélectionnez Ajouter.
Un sélecteur s'ouvre et affiche les espaces disponibles liés au groupe d'automatisation. Sélectionnez un ou plusieurs espaces contenant les bases de connaissances que vous souhaitez que l'agent utilise.
Choisissez Enregistrer.
L'agent personnalisé peut désormais rechercher et récupérer le contenu des bases de connaissances dans les espaces sélectionnés lors de l'exécution de l'automatisation.
Lorsque vous associez un espace, toutes les bases de connaissances qu'il contient sont automatiquement accessibles à l'agent. Il n'est pas nécessaire de joindre chaque base de connaissances individuellement. Au moment de l'exécution, l'agent interroge chaque base de connaissances indépendamment et combine les résultats dans sa réponse.
Note
Si le propriétaire du groupe d'automatisation perd l'accès à une base de connaissances spécifique au sein de l'espace, cette base de connaissances est ignorée lors des requêtes et l'éditeur de flux de travail affiche un badge d'avertissement sur la pièce jointe à l'espace.
Instructions de rédaction pour les requêtes de la base de connaissances
Lorsqu'un agent personnalisé est associé à des bases de connaissances, il recherche et récupère automatiquement le contenu pertinent en fonction de vos instructions. Rédigez des instructions qui décrivent clairement les informations que l'agent doit trouver ou comment il doit utiliser le contenu de la base de connaissances.
Bonnes pratiques :
Soyez précis quant aux informations à récupérer ou à résumer
Référencez le type de contenu que vous vous attendez à ce que l'agent trouve (par exemple, « Recherchez... dans les documents de politique » ou « Trouvez des informations sur... »)
Spécifiez comment l'agent doit utiliser les informations récupérées dans sa réponse
Incluez des instructions de secours lorsque la base de connaissances ne contient pas de contenu pertinent
Exemple : agent chargé des demandes de renseignements auprès des clients avec base de connaissances
L'exemple suivant montre comment configurer un agent personnalisé qui utilise une base de connaissances pour répondre aux demandes des clients sur la base de la documentation de l'entreprise.
Configuration :
Un espace contenant une base de connaissances avec la documentation du produit et le contenu des FAQ
L'espace est lié au groupe d'automatisation
L'espace est ajouté en tant que connaissance à l'agent personnalisé
Instructions :
"""You are a customer support agent. Task: Answer the customer inquiry using information from the knowledge base. Instructions: 1. Search the knowledge base for information relevant to the customer's question. 2. Provide a clear, concise answer based on the retrieved content. 3. If the knowledge base does not contain relevant information, respond with: "I don't have enough information to answer this question. Please escalate to a human agent." Constraints: - Only use information found in the knowledge base. Do not make up answers. - Keep responses under 200 words. - Include the source document name when referencing specific information."""
Sortie structurée :
{ "answer": "The response to the customer inquiry", "sourceDocument": "Name of the document used", "confidence": "high/medium/low", "escalationNeeded": false }