Arcade Assistant (Beta) verwendet künstliche Intelligenz (KI), um ArcGIS Arcade-Ausdrücke aus in natürlicher Sprache eingegebenen Anweisungen zu generieren. Um optimale Ergebnisse zu erzielen, verwenden Sie eine klare und einfache Sprache, und gehen Sie auf die erhaltenen Antworten ein.
ArcGIS Experience Builder unterstützt die Verwendung von Arcade, um Daten hinzufügen und die Anwendung erweiterter Formatierung auf Widgets und Listenelemente. In allen Fällen geben Sie Skripte in einen Arcade-Editor ein, der in Arcade Assistant (Beta) enthalten ist.
Hinweis:
Arcade Assistent (Beta) wird auf der Ebene der Organisation verwaltet und muss von Ihrem Administrator aktiviert werden.
Verwenden des Assistenten
Führen Sie die folgenden Schritte aus, um Arcade Assistant (Beta) in Experience Builder zu nutzen:
- Überprüfen Sie, ob Sie bei einer Organisation angemeldet sind.
Sie müssen sich als Mitglied einer Organisation mit einer Rolle anmelden, die Berechtigungen zur Nutzung von KI-Assistenten umfasst.
- Öffnen Sie den Arcade-Editor in Experience Builder.
Sie können den Arcade-Editoren an folgenden Stellen öffnen:
- Klicken Sie auf Arcade Assistant
.Daraufhin wird der Bereich Arcade Assistant angezeigt.
- Gehen Sie zur Verwendung des Assistenten wie folgt vor:
- Klicken Sie auf einen Vorschlag und ändern Sie ihn, um einen Prompt zu erstellen, der Ihren Daten entspricht.
- Geben Sie einen Prompt in Ihrer bevorzugten Sprache ein, um einen Arcade-Ausdruck zu erstellen.
- Klicken Sie auf Erstellen, um die Abfrage auszuführen.
Im Fenster Arcade Assistant werden der von Arcade Assistant (Beta) vorgeschlagene Ausdruck angezeigt.
Tipp:
Zeigen Sie auf die Schaltfläche Profilkontext
, um zu sehen, wo der vorgeschlagene Ausdruck in der Layer-Konfiguration angewendet wird. - Führen Sie die folgenden Schritte aus, um mit dem Vorschlag zu interagieren:
- Klicken Sie auf Dem Editor hinzufügen, um den Ausdruck zum Fenster "Ausdruck-Generator" hinzuzufügen.
Tipp:
Setzen Sie im Fenster "Ausdruck-Generator" den Mauszeiger an die Stelle, an der der Inhalt hinzugefügt werden soll. Bewegen Sie z. B. den Mauszeiger im Fenster "Ausdruck-Generator", und klicken Sie vor eine vorhandene Codezeile. Wenn Sie im Bereich Arcade Assistant auf Zum Editor hinzufügen klicken, wird der vorgeschlagene Ausdruck zum Fenster "Ausdruck-Generator" an der Position des Mauszeigers hinzugefügt.
- Klicken Sie auf Gesamten Code im Editor ersetzen
, um alle vorhandenen Inhalte im Fenster "Ausdruck-Generator" durch den vorgeschlagenen Ausdruck zu ersetzen. - Klicken Sie auf Code in die Zwischenablage kopieren
, um den vorgeschlagenen Ausdruck in die Zwischenablage zu kopieren. - Um Anpassungen am Prompt vorzunehmen, bearbeiten Sie den vorherigen Prompt im Textbereich oder kopieren Sie einen vorherigen Prompt, und fügen Sie ihn ein, und klicken Sie auf Optimieren, um die geänderte Abfrage zu senden.
- Um Feedback zum Assistenten zu geben, klicken Sie auf die Schaltfläche Hilfreich
oder Nicht hilfreich
, und füllen Sie den Survey aus. Das Feedback wird für die zukünftige Entwicklung genutzt.
- Klicken Sie auf Dem Editor hinzufügen, um den Ausdruck zum Fenster "Ausdruck-Generator" hinzuzufügen.
- Um den Abfrageverlauf zu löschen und neu zu beginnen, können Sie jederzeit auf Erneut starten klicken.
Best Practices
Im Folgenden finden Sie Richtlinien, die Ihnen beim Generieren von Arcade-Ausdrücken mit Arcade Assistant (Beta) helfen.
- Formulieren Sie Ihre Anfragen klar und deutlich.
- Vermeiden Sie Mehrdeutigkeit und vage Formulierungen.
- Auch wenn die Verwendung genauer Feldnamen nicht erforderlich ist, wird die Angabe von ausreichenden Details empfohlen.
Kontext-Einschränkungen
Berücksichtigen Sie bei der Verwendung von Arcade Assistant (Beta) folgende Einschränkungen:
- Der Assistent ist kein Chatbot. Er merkt sich keine Informationen, die Sie bei früheren Prompts eingegeben haben. Wenn Sie einen früheren Prompt verfeinern, stellen Sie sicher, dass Sie alle relevanten Details einbeziehen, als ob Sie den Assistenten zum ersten Mal fragen würden.
Hinweis:
Im Folgenden finden Sie Beispiele für eine produktive Prompt-Sequenz und eine unproduktive Prompt-Sequenz:
- Produktive sequenzielle Prompts
- "Wenn keine Features ausgewählt sind, 'Alle Regionen' zurückgeben. Wenn Features ausgewählt sind, die Namen der ausgewählten Features zurückgeben." Der Assistent generiert ein Skript, das zu viele Ortsnamen auflistet, die nicht in das Widget "Text" passen, wenn viele Features ausgewählt sind.
- "Wenn keine Features ausgewählt sind, 'Alle Regionen' zurückgeben. Wenn Features ausgewählt sind, die Namen der ausgewählten Features zurückgeben. Wenn mehr als drei Features ausgewählt sind, die Namen der drei ausgewählten Features zurückgeben." Der Kontext des ursprünglichen Prompts bleibt erhalten, wobei zusätzlich darum gebeten wird, die Anzahl der Namen auf drei zu beschränken, wodurch eine produktive Prompt-Sequenz entsteht.
- Unproduktive sequenzielle Prompts
- "Wenn keine Features ausgewählt sind, 'Alle Regionen' zurückgeben. Wenn Features ausgewählt sind, die Namen der ausgewählten Features zurückgeben."
- "Nur bis zu drei Namen zurückgeben." Der Kontext des ursprünglichen Prompts geht verloren, wodurch diese Prompt-Sequenz unproduktiv wird.
- Produktive sequenzielle Prompts
- Der Assistent kennt keine zuvor erzeugten Arcade-Ausdrücke oder bereits vorhandene Ausdrücke im Arcade-Editor.
Tipp:
Im Folgenden finden Sie Beispiele für einen produktiven Prompt und einen unproduktiven Prompt:
- Produktiver Prompt: "Vereinfache diesen Ausdruck: <Ausdruck hier einfügen>." Dieser Prompt ist produktiv, weil der Benutzer genügend Kontext geliefert hat, damit der Assistent einen Ausdruck erzeugen kann.
- Unproduktiver Prompt: "Vereinfache den Ausdruck im Editor." Dieser Prompt ist unproduktiv, da der Assistent den Ausdruck im Editor nicht kennt.
- Der Assistent fragt Ihre Daten nicht ab. Aus diesem Grund kennt er keine spezifischen Datenwerte, die im Layer vorhanden sind, für den Sie den Ausdruck erstellen. Wenn Sie möchten, dass der Assistent bedingte Logik auf der Grundlage von Datenwerten schreibt, müssen Sie diese in Ihrem Prompt angeben oder dem großen Sprachmodell erlauben, die Werte anzunehmen.
Tipp:
Im Folgenden finden Sie Beispiele für einen produktiven Prompt und einen unproduktiven Prompt:
- Produktiver Prompt: "Wenn die Bevölkerungsdichte über 500 liegt, 'hohe Dichte' zurückgeben. Wenn sie zwischen 100 und 500 liegt, 'moderate Dichte' zurückgeben. Wenn sie unter 100 liegt, 'niedrige Dichte' zurückgeben. Dieser Prompt ist produktiv, weil die Werte spezifisch sind und die Kategorien definiert sind.
- Unproduktiver Prompt: "Das Feld der Bevölkerungsdichte anhand natürlicher Unterbrechungen in mehrere Kategorien einteilen: 'hohe Dichte', 'moderate Dichte' und 'niedrige Dichte'." Dieser Prompt ist unproduktiv, da der Assistent den Wertebereich, der kategorisiert werden soll, nicht kennt.
- Sie können den Assistenten nicht verwenden, um andere Layer zu suchen, zu referenzieren oder abzufragen. Der einzige Kontext, der dem Assistenten zur Verfügung steht, sind Feldnamen und Aliasnamen für die Layer, die mit dem Ausdruck verknüpft sind. Außerdem kennt der Assistent keine Anlagen und zugehörige Tabellen, die mit den Layern verknüpft sein können. Aus diesem Grund gibt es nur eine eingeschränkte Unterstützung für die Erstellung von Ausdrücken mit FeatureSet-Funktionen. Wenn Sie Daten hinzufügen oder auf Daten aus anderen Layern zugreifen möchten, geben Sie den Layer-Titel oder die Element-ID für den Assistenten an, damit er weiß, welche Informationen er in dem Ausdruck berücksichtigen soll. Wenn Sie diese Informationen nicht angeben, generiert der Assistent einen Titel oder eine ID, die Sie manuell ersetzen müssen, wenn der generierte Ausdruck dem Fenster "Ausdruck-Generator" hinzugefügt wird.
Tipp:
Im Folgenden finden Sie Beispiele für einen produktiven Prompt und einen unproduktiven Prompt:
- Die Anzahl der Vorfälle zurückgeben, die sich innerhalb der Grenzen des Staates Washington ereignet haben. Das Feld NAME im Layer 'us_states_2000' zum Durchführen der Berechnung verwenden." Dieser Prompt ist produktiv, da er die spezifische geographische Grenze und den Layer in der Karte definiert, die bei der Erstellung des Ausdrucks verwendet werden soll.
- Unproduktiver Prompt: "Die Anzahl der Vorfälle zurückgeben, die sich in Washington ereignet haben." Dieser Prompt ist unproduktiv, weil unklar ist, ob der Bundesstaat Washington oder Washington, D.C. gemeint ist. Außerdem ist unklar, welcher Layer in der Karte für die Abfrage verwendet werden soll.