Asystent języka Arcade (beta) wykorzystuje sztuczną inteligencję (AI) do generowania wyrażeń w języku ArcGIS Arcade na podstawie instrukcji wpisywanych w naturalnym języku.
Za pomocą języka Arcade można tworzyć zasoby niestandardowe oparte na danych w różnych kontekstach tworzenia map, takich jak stylizowanie warstw, konfigurowanie okienek podręcznych i konfigurowanie etykiet. Języka Arcade można na przykład używać do dynamicznego wyświetlania nowych informacji z istniejących pól w warstwie na podstawie wartości danych i progów zdefiniowanych przez użytkownika. Podobnie jak w przypadku innych języków kodowania, pisanie wyrażeń Arcade i diagnozowanie błędów w nich zawartych może zająć trochę czasu. Asystent języka Arcade (beta) może pomóc w zwiększeniu wydajności tego procesu, generując wyrażenie lub jego część bez konieczności pisania kodu.
Notatka:
Aby uzyskać więcej informacji o asystencie, w tym o zużyciu kredytów, bezpieczeństwie i prywatności oraz ograniczeniach i odchyleniach, zapoznaj się z tematem Asystent języka Arcade (beta).
Korzystanie z asystenta
Asystent języka Arcade (beta) wykorzystuje naturalny język do generowania kodu Arcade. Aby uzyskać najlepsze wyniki, używaj przejrzystego i prostego języka oraz iteruj na podstawie otrzymywanych odpowiedzi.
Notatka:
Asystent jest zarządzany na poziomie instytucji ArcGIS Online i może zostać wyłączony przez administratora.
Aby skorzystać z asystenta, wykonaj następujące czynności:
- Upewnij się, że jesteś użytkownikiem zalogowanym w instytucji.
- Kliknij przycisk App Launcher
i wybierz aplikację Map Viewer. Użyj nowo otwartej mapy i dodaj warstwę do mapy lub otwórz istniejącą mapę. - Otwórz okno edytora wyrażeń atrybutowych z poziomu okienka Style, Okna podręczne lub Etykiety obiektów.
Notatka:
Aby uzyskać dodatkowe informacje na temat stylizowania warstwy za pomocą wyrażenia, zobacz temat Stosowanie stylu. Aby skonfigurować okienka podręczne za pomocą wyrażenia, zobacz temat Używanie wyrażeń. Aby skonfigurować etykiety za pomocą wyrażenia, zobacz temat Stosowanie etykiet.
- Kliknij przycisk Asystent języka Arcade
.Zostanie otwarte okienko Asystent języka Arcade.
- Użyj asystenta, wykonując jedną z poniższych czynności:
- Kliknij sugestię i zmodyfikuj ją, aby utworzyć polecenie pasujące do Twoich danych.
- Wprowadź polecenie w preferowanym języku, aby utworzyć wyrażenie w języku Arcade.
- Kliknij przycisk Generuj, aby wykonać zapytanie.
Asystent języka Arcade (beta) sugeruje wyrażenie w panelu Asystent języka Arcade.
Wskazówka:
Umieść wskaźnik myszy na przycisku Kontekst profilu
, aby zobaczyć, gdzie sugerowane wyrażenie zostanie zastosowane w konfiguracji warstwy. Umieść wskaźnik myszy na przycisku Kontekst warstwy 
, aby wyświetlić metadane warstwy dostarczone do asystenta używanego do generowania sugerowanego wyrażenia. - Aby wejść w interakcję z sugestią, wykonaj jedną z poniższych czynności:
- Kliknij przycisk Dodaj do edytora, aby dodać wyrażenie do panelu kreatora wyrażeń.
Wskazówka:
Umieść wskaźnik w panelu kreatora wyrażeń w miejscu, w którym chcesz dodać zasoby. Na przykład w panelu kreatora wyrażeń przesuń wskaźnik i kliknij przed istniejącą linią kodu. Gdy klikniesz przycisk Dodaj do edytora w panelu asystenta języka Arcade, sugerowane wyrażenie zostanie dodane do panelu kreatora wyrażeń w miejscu, w którym znajduje się kursor.
- Kliknij przycisk Zastąp cały kod w edytorze
, aby zastąpić istniejące zasoby w panelu kreatora wyrażeń sugerowanym wyrażeniem. - Kliknij Skopiuj kod do schowka
, aby skopiować sugerowane wyrażenie do schowka. - Aby wprowadzić zmiany w poleceniu, edytuj poprzednie polecenie w obszarze tekstowym lub skopiuj i wklej poprzednie polecenie, a następnie kliknij przycisk Dopracuj, aby przesłać zmodyfikowane zapytanie.
- Aby wyrazić opinię na temat asystenta, kliknij przycisk Pomocny
lub Nieprzydatny 
i wypełnij ankietę. Informacje zwrotne są używane podczas dalszego rozwijania produktu.
- Kliknij przycisk Dodaj do edytora, aby dodać wyrażenie do panelu kreatora wyrażeń.
Najważniejsze wskazówki
Następujące wytyczne pomogą Ci w generowaniu wyrażeń w języku Arcade za pomocą Asystenta języka Arcade (beta):
- Twoje żądanie powinno być jasne i zwięzłe.
- Unikaj dwuznaczności i niejasnego języka.
- Mimo że używanie dokładnych nazw pól nie jest wymagane, zaleca się podanie wystarczającej ilości szczegółów.
Wskazówka:
Poniżej znajdziesz porównanie produktywnego i bezproduktywnego polecenia do tworzenia wyrażenia konfigurującego etykiety:
- Produktywne polecenie: „Oznacz każdy powiat etykietą z całkowitymi zbiorami pszenicy z ubiegłego roku. Jeśli powiat nie wyprodukował pszenicy, nie wyświetlaj etykiety”. To polecenie jest produktywne, ponieważ jest jasne i zwięzłe oraz zawiera wyraźną akcję.
- Bezproduktywne polecenie: „Wybierz etykietę dla obiektów”. To polecenie jest bezproduktywne, ponieważ asystent nie wybiera sposobu oznaczania obiektów etykietami. Asystent generuje wyrażenia wyłącznie na podstawie instrukcji autora. Autor mapy powinien zdecydować, jakie obiekty chce oznaczyć i w jaki sposób to zrobić, a następnie poprosić asystenta o wygenerowanie wyrażenia, aby osiągnąć cel.
Ograniczenia kontekstowe
Pamiętaj o następujących ograniczeniach podczas korzystania z asystenta języka Arcade (beta):
- Asystent nie jest chatbotem. Nie zapamiętuje informacji podanych w poprzednich poleceniach. Dopracowując poprzednie polecenie, pamiętaj o uwzględnieniu wszystkich istotnych szczegółów, tak jakby pytanie było wysyłane do asystenta po raz pierwszy.
Wskazówka:
Obejrzyj poniższy przykład porównania produktywnej i bezproduktywnej sekwencji poleceń:
- Produktywna sekwencja poleceń:
- „Utwórz tabelę HTML, w której każdy wiersz jest polem populacji”. Asystent wygeneruje tabelę, ale bez formatowania.
- „Utwórz tabelę HTML, w której każdy wiersz jest polem populacji. Sformatuj liczby za pomocą przecinków”. Kontekst związany z tworzeniem tabeli HTML został zachowany, ale podano dodatkowe szczegóły w postaci prośby o sformatowanie pól, więc jest to produktywna sekwencja poleceń.
- Bezproduktywna sekwencja poleceń:
- „Utwórz tabelę HTML, w której każdy wiersz jest polem populacji”.
- „Teraz sformatuj liczby za pomocą przecinków”. Teraz brakuje kontekstu związanego z tworzeniem tabeli HTML, co sprawia, że jest to bezproduktywna sekwencja poleceń.
- Produktywna sekwencja poleceń:
- Asystent nie jest świadomy żadnych wygenerowanych wcześniej wyrażeń w języku Arcade ani wyrażeń istniejących w edytorze języka Arcade lub na mapie internetowej.
Wskazówka:
Obejrzyj poniższy przykład z porównaniem produktywnego i bezproduktywnego polecenia:
- Produktywne polecenie: „Uprość to wyrażenie: <wstaw tutaj wyrażenie>”. To polecenie jest produktywne, ponieważ użytkownik podał wystarczający kontekst, aby asystent mógł wygenerować wyrażenie.
- Bezproduktywne polecenie: „Uprość wyrażenie w edytorze”. To polecenie jest bezproduktywne, ponieważ asystent nie jest świadomy wyrażenia w edytorze.
- Asystent nie śledzi Twoich danych. Nie zna zatem konkretnych wartości danych w warstwie, w przypadku której generujesz wyrażenie. Jeśli chcesz, aby asystent utworzył warunkowe wyrażenie logiczne w oparciu o wartości danych, musisz podać je w poleceniu lub pozwolić, aby duży model językowy przyjął te wartości.
Wskazówka:
Obejrzyj poniższy przykład z porównaniem produktywnego i bezproduktywnego polecenia:
- Produktywne polecenie: „Jeśli wynik jest wyższy niż 100, zwróć wartość »dobry«. Jeśli jest wyższy niż 75, zwróć wartość »umiarkowany«. Jeśli mieści się w zakresie 20-75, zwróć wartość »zły«. Jeśli jest niższy niż 20, zwróć wartość »bardzo zły«. To polecenie jest produktywne, ponieważ wartości są konkretne, a kategorie – zdefiniowane.
- Bezproduktywne polecenie: „Podziel pole wyniku na wiele kategorii, używając naturalnych podziałów »dobry«, »umiarkowany«, »zły«, »okropny«”. To polecenie jest nieproduktywne, ponieważ asystent nie zna zakresu wartości do skategoryzowania.
- Nie możesz używać asystenta do wyszukiwania, odwoływania się do innych warstw na mapie ani ich odpytywania. Jedynym kontekstem, który zna asystent, są nazwy pól i aliasy w warstwie wykonującej wyrażenie. Ponadto asystent nie jest świadomy załączników i powiązanych tabel, które mogą być powiązane z warstwą. Dlatego wsparcie dotyczące generowania wyrażeń przy użyciu funkcji FeatureSet jest ograniczone. Aby uzyskać dostęp do danych z innych warstw, musisz podać tytuł warstwy lub identyfikator elementu, aby asystent wiedział, które informacje uwzględnić w wyrażeniu. Jeśli te informacje nie zostaną podane, asystent wygeneruje tytuł lub identyfikator, który trzeba będzie ręcznie zastąpić, gdy wygenerowane wyrażenie zostanie dodane do panelu kreatora wyrażeń.
Wskazówka:
Obejrzyj poniższy przykład z porównaniem produktywnego i bezproduktywnego polecenia:
- Produktywne polecenie: „Zwróć liczbę wypadków, do których doszło w granicach stanu Waszyngton. Użyj pola NAME w warstwie us_states_2000, aby wykonać te obliczenia”. To polecenie jest produktywne, ponieważ definiuje konkretne granice obszaru geograficznego i warstwę na mapie, która powinna zostać użyta podczas generowania wyrażenia.
- Bezproduktywne polecenie: „Zwróć liczbę wypadków, do których doszło w Waszyngtonie”. To polecenie jest bezproduktywne, ponieważ nie jest jasne, czy chodzi o stan Waszyngton czy miasto Waszyngton. Ponadto nie wiadomo, która warstwa na mapie powinna być używana podczas wykonywania zapytania.