Utiliser l’assistant Arcade (bêta) dans Experience Builder

L’assistant Arcade (bêta) utilise l’intelligence artificielle (IA) pour générer des expressions ArcGIS Arcade à partir d’instructions saisies en langage naturel. Pour de meilleurs résultats, utilisez un langage simple et clair, et effectuez une itération sur les réponses que vous recevez.

ArcGIS Experience Builder prend en charge l’utilisation de Arcade pour ajouter des données et appliquer une mise en forme avancée aux widgets et aux éléments de liste. Dans tous les cas, vous saisissez les scripts dans un éditeur Arcade qui inclut l’assistant Arcade (bêta).

Remarque :

L’assistant Arcade (bêta) est administré au niveau de l’organisation et doit être activé par votre administrateur.

Utiliser l’assistant

Pour utiliser l’assistant Arcade (bêta) dans Experience Builder, procédez comme suit :

1. Vérifiez que vous êtes connecté à une organisation.

   Vous devez vous connecter en tant que membre d’une organisation avec un rôle doté des privilèges d’utilisation des assistants IA.

2. Dans Experience Builder, ouvrez l’éditeur Arcade.

   Vous pouvez ouvrir l’éditeur Arcade depuis les emplacements suivants :

   • Le volet Add Data (Ajouter des données)
   • Les paramètres de style dynamique pour les widgets Button (Bouton), List (Liste) et Text (Texte)
   • La barre d’outils du widget Text (Texte)
   • Les paramètres de texte du widget Button (Bouton)
   • Les paramètres source du widget Image
   • Les paramètres du lien lors de la configuration d’un lien par URL
3. Cliquez sur Arcade assistant (Assistant Arcade) .

   La fenêtre Arcade assistant (Assistant Arcade) s’affiche.

4. Utilisez l’assistant de l’une des manières suivantes :
   • Cliquez sur une suggestion et modifiez-la pour générer une instruction adaptée à vos données.
   • Saisissez une instruction dans la langue de votre choix pour générer une expression Arcade.
5. Cliquez sur Generate (Générer) pour exécuter la requête.

   L’assistant Arcade (bêta) suggère une expression dans la fenêtre Arcade assistant (Assistant Arcade).

   Conseil :

   Survolez le bouton Profile context (Contexte du profil)  pour voir où l’expression suggérée sera appliquée dans la configuration de la couche.

6. Pour interagir avec la suggestion, procédez de l’une des manières suivantes :
   • Cliquez sur Add to editor (Ajouter à l’éditeur) pour ajouter l’expression dans la fenêtre du générateur d’expressions.

     Conseil :

     Positionnez le pointeur dans la fenêtre du générateur d’expressions à l’endroit où vous voulez ajouter le contenu. Par exemple, dans la fenêtre du générateur d’expressions, déplacez le pointeur et cliquez devant une ligne de code existante. Lorsque vous cliquez sur Add to editor (Ajouter à l’éditeur) dans la fenêtre Arcade assistant (Assistant Arcade), l’expression suggérée est ajoutée dans la fenêtre du générateur d’expressions à la position du pointeur.

   • Cliquez sur Replace all code in editor (Remplacer tout le code dans l’éditeur)  pour remplacer tout code existant dans la fenêtre du générateur d’expressions par l’expression suggérée.
   • Cliquez sur Copy code to clipboard (Copier le code dans le Presse-papiers)  pour copier l’expression suggérée dans le Presse-papiers.
   • Pour ajuster l’instruction, modifiez l’instruction précédente dans la zone de texte ou copiez et collez une instruction précédente et cliquez sur Refine (Affiner) pour envoyer la requête modifiée.
   • Pour envoyer des commentaires sur l’assistant, cliquez sur le bouton Helpful (Utile)  ou Unhelpful (Pas utile)  et répondez à l’enquête. Les commentaires sont utilisés pour orienter le développement futur.
7. Pour effacer l’historique de requêtes et recommencer, cliquez sur Start over (Recommencer) à tout moment.

Comprendre les bonnes pratiques

Voici quelques indications pour vous aider à générer des expressions Arcade en utilisant l’assistant Arcade (bêta) :

• Formulez vos demandes de manière claire et concise.
• Évitez les ambiguïtés et les imprécisions.
• S’il n’est pas nécessaire d’utiliser les noms de champs exacts, il est recommandé d’indiquer suffisamment de détails.

Comprendre les limitations relatives au contexte

Gardez à l’esprit les limitations suivantes lorsque vous utilisez l’assistant Arcade (bêta) :

• L’assistant n’est pas un agent conversationnel. Il ne se souvient pas des informations que vous avez fournies dans les instructions précédentes. Lorsque vous affinez une instruction précédente, assurez-vous d’inclure tous les détails pertinents, comme si vous demandiez quelque chose à l’assistant pour la première fois.

  Remarque :

  Voici des exemples de séquence d’instructions productive et de séquence d’instructions non productive :

  • Instructions séquentielles productives :
    • « Lorsqu’aucune entité n’est sélectionnée, renvoyer "Toutes les régions". Lorsque des entités sont sélectionnées, renvoyer les noms des entités sélectionnées. » L’assistant génère un script qui répertorie trop de noms de lieux pour un affichage correct dans le widget Text (Texte) si beaucoup d’entités sont sélectionnées.
    • « Lorsqu’aucune entité n’est sélectionnée, renvoyer "Toutes les régions". Lorsque des entités sont sélectionnées, renvoyer les noms des entités sélectionnées. Si plus de trois entités sont sélectionnées, renvoyer les noms de trois entités sélectionnées. » Le contexte de l’instruction d’origine est conservé, mais une demande supplémentaire indique de limiter le nombre de noms à trois, ce qui en fait une séquence d’instructions productive.
  • Instructions séquentielles non productives :
    • « Lorsqu’aucune entité n’est sélectionnée, renvoyer "Toutes les régions". Lorsque des entités sont sélectionnées, renvoyer les noms des entités sélectionnées. »
    • « Renvoyer uniquement trois noms. » Le contexte de l’instruction d’origine est perdu, ce qui en fait une série d’instructions non productive.

• L’assistant ne connaît pas les expressions Arcade générées précédemment ni les expressions qui existent dans l’éditeur Arcade.

  Conseil :

  Voici des exemples d’instruction productive et d’instruction non productive :

  • Instruction productive : « Simplifier cette expression : <insérez une expression ici>. ». Cette instruction est productive, car l’utilisateur a fourni suffisamment de contexte pour que l’assistant puisse générer une expression.
  • Instruction non productive : « Simplifier l’expression dans l’éditeur. » Cette instruction n’est pas productive car l’assistant ne connaît pas l’expression qui se trouve dans l’éditeur.

• L’assistant n’interroge pas vos données. Par conséquent, il ne connaît pas les valeurs de données spécifiques présentes dans la couche pour laquelle vous générez l’expression. Si vous voulez que l’assistant écrive une logique conditionnelle basée sur des valeurs de données, vous devez fournir ces valeurs de données dans votre instruction ou autoriser le modèle de langage à les supposer.

  Conseil :

  Voici des exemples d’instruction productive et d’instruction non productive :

  • Instruction productive : « Si la densité de population est supérieure à 500, renvoyer "densité élevée". Si elle est comprise entre 100 et 500, renvoyer "densité modérée". Si elle est inférieure à 100, renvoyer "densité faible". Cette instruction est productive, car les valeurs sont spécifiques et les catégories sont définies.
  • Instruction non productive : « Répartir le champ de densité de population en plusieurs catégories selon des seuils naturels : "densité élevée", "densité modérée" et "densité faible". » Cette instruction n’est pas productive, car l’assistant ne connaît pas les plages de valeurs à catégoriser.

• Vous ne pouvez pas utiliser l’assistant pour rechercher, référencer ou interroger d’autres couches. Les noms de champ et les alias pour les couches associées à l’expression constituent le seul contexte dont dispose l’assistant. De plus, l’assistant ne connaît pas les pièces jointes et les tables associées pouvant être liées aux couches. Par conséquent, la prise en charge de la génération d’expressions à l’aide des fonctions FeatureSet est limitée. Si vous souhaitez ajouter des données ou accéder aux données d’autres couches, spécifiez le titre de la couche ou l’ID d’élément pour que l’assistant dispose des informations à inclure dans l’expression. Si vous ne fournissez pas ces informations, l’assistant générera un titre ou un ID que vous devrez remplacer manuellement lors de l’ajout de l’expression générée dans la fenêtre du générateur d’expressions.

  Conseil :

  Voici des exemples d’instruction productive et d’instruction non productive :

  • « Renvoyer le nombre d’incidents qui se sont produits dans la limite de l’État de Washington. Utiliser le champ NAME de la couche us_states_2000 pour effectuer ce calcul. » Cette instruction est productive car elle définit la limite géographique spécifique et la couche de la carte à utiliser lors de la génération de l’expression.
  • Instruction non productive : « Renvoyer le nombre d’incidents qui se sont produits à Washington. » Cette instruction n’est pas productive, car elle ne précise pas s’il s’agit de l’État de Washington, de Washington, D.C ou d’une autre localisation ayant un nom similaire. De plus, la couche de la carte à utiliser pour répondre à la requête n’est pas clairement définie.