Utiliser l’assistant Arcade (bêta)

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.

Arcade permet de créer du contenu dynamique personnalisé dans divers contextes cartographiques, comme la stylisation des couches, la configuration des fenêtres contextuelles et la configuration des étiquettes. Par exemple, vous pouvez utiliser Arcade pour afficher dynamiquement de nouvelles informations à partir de champs existants dans la couche selon des valeurs de données et des seuils que vous définissez. Comme avec d’autres langages de codage, l’écriture et le diagnostic des erreurs dans des expressions Arcade peuvent prendre un certain temps. L’assistant Arcade (bêta) contribue à optimiser ce processus par la génération d’une expression, ou d’une partie d’une expression, sans aucune écriture de code de votre part.

Remarque :

Pour plus d’informations sur l’assistant, notamment la consommation de crédits, la sécurité et la confidentialité ainsi que les limitations et les biais, reportez-vous à la rubrique Assistant Arcade (bêta).

Utiliser l’assistant

L’assistant Arcade (bêta) utilise le langage naturel pour générer du code Arcade. Pour de meilleurs résultats, utilisez un langage simple et clair, et effectuez une itération sur les réponses que vous recevez.

Remarque :

L’assistant est administré au niveau de l’organisation ArcGIS Online et peut être désactivé par votre administrateur.

Pour utiliser l’assistant, procédez comme suit :

1. Vérifiez que vous êtes connecté à une organisation.
2. Cliquez sur le lanceur d’applications  et sélectionnez Map Viewer. Utilisez la nouvelle carte qui s’ouvre et ajoutez une couche à la carte ou ouvrez une carte existante.
3. Ouvrez la fenêtre de l’éditeur d’expressions attributaires à partir du volet Styles, Pop-ups (Fenêtres contextuelles) ou Label features (Étiqueter les entités).

   Remarque :

   Pour plus d’informations sur la stylisation d’une couche à l’aide d’une expression, reportez-vous à la section Appliquer un style. Pour configurer des fenêtres contextuelles à l’aide d’une expression, reportez-vous à la section Utiliser des expressions. Pour configurer des étiquettes à l’aide d’une expression, reportez-vous à la section Appliquer les étiquettes.

4. Cliquez sur Arcade assistant (Assistant Arcade) .

   Le volet Arcade assistant (Assistant Arcade) s’ouvre.

5. 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.
6. 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. Survolez le bouton Layer context (Contexte de la couche) pour voir les métadonnées de la couche fournies à l’assistant utilisé pour générer l’expression suggérée.

7. 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 votre curseur 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 votre curseur 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 curseur.

   • 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, puis 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.

Comprendre les bonnes pratiques

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

• Formulez votre demande 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.

Conseil :

Voici un exemple d’instruction productive et un exemple d’instruction non productive pour créer une expression de configuration d’étiquettes :

• Instruction productive : « Étiqueter chaque comté avec la récolte totale de blé de l’année précédente. Si un comté ne produit pas de blé, ne pas afficher d’étiquette. » Cette instruction est pertinente parce qu’elle est claire, concise et réalisable.
• Instruction non productive : « Sélectionner une étiquette pour les entités. » Cette instruction n’est pas productive car l’assistant ne choisit pas la façon d’étiqueter les entités. Il génère uniquement des expressions en fonction des instructions du créateur. Le créateur de la carte doit choisir les entités qu’il souhaite étiqueter ainsi que la façon de les étiqueter, puis demander à l’assistant de générer une expression qui permet d’atteindre son objectif.

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.

  Conseil :

  Voici un exemple de séquence d’instructions productive et un exemple de séquence d’instructions non productive :

  • Instructions séquentielles productives :
    • « Créer une table HTML dans laquelle chaque ligne est un champ de population. » L’assistant génère une table, mais sans mise en forme.
    • « Créer une table HTML dans laquelle chaque ligne est un champ de population. Mettre en forme les nombres avec des virgules. » Le contexte de création d’une table HTML est conservé, mais un détail supplémentaire a été ajouté pour mettre en forme les champs, ce qui rend cette séquence d’instructions productive.
  • Instructions séquentielles non productives :
    • « Créer une table HTML dans laquelle chaque ligne est un champ de population. »
    • « Maintenant, mettre en forme les nombres avec des virgules. » Ici, le contexte de création d’une table HTML manque, ce qui rend cette séquence 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 ou la carte Web.

  Conseil :

  Voici un exemple d’instruction productive et un exemple 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 un exemple d’instruction productive et un exemple d’instruction non productive :

  • Instruction productive : « Si le score est supérieur à 100, renvoyer ‘bon’ ». S’il est supérieur à 75, renvoyer ‘moyen’. S’il est compris entre 20 et 75, renvoyer ‘mauvais’. S’il est inférieur à 20, renvoyer ‘horrible’. » Cette instruction est productive car les valeurs sont spécifiques et les catégories sont définies.
  • Invite non productive : « Diviser le champ de score en plusieurs catégories en utilisant des mentions en langage naturel : ‘bon’, ‘moyen’, ‘mauvais’, ‘horrible’. » Cette instruction n’est pas productive car l’assistant ne connaît pas les plages de valeurs pour chaque catégorie.

• Vous ne pouvez pas utiliser l’assistant pour rechercher, référencer ou interroger d’autres couches de la carte. Les noms de champ et les alias pour la couche exécutant 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 à la couche. 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 accéder aux données d’autres couches, vous devez fournir le titre de la couche ou l’ID d’élément pour que l’assistant connaisse les informations à inclure dans l’expression. Si ces informations ne sont pas fournies, 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 un exemple d’instruction productive et un exemple d’instruction non productive :

  • Instruction 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 ou de Washington, D.C. De plus, la couche de la carte à utiliser lors de la requête n’est pas clairement définie.