O assistente do Arcade (beta) usa inteligência artificial (IA) para gerar expressões do ArcGIS Arcade a partir de instruções digitadas em linguagem natural.
O Arcade pode ser usado para criar conteúdo personalizado baseado em dados em vários contextos de mapeamento, como estilização de camadas, configuração de pop-ups e configuração de rótulos. Por exemplo, você pode usar Arcade para exibir dinamicamente novas informações de campos existentes na camada com base nos valores de dados e limites definidos por você. Semelhante a outras linguagens de codificação, escrever e diagnosticar erros em expressões Arcade pode levar tempo. O assistente Arcade (beta) pode ajudar a melhorar a eficiência desse processo gerando uma expressão ou parte de uma expressão sem que você precise escrever nenhum código.
Anotação:
Para obter mais informações sobre o assistente, incluindo consumo de crédito, segurança e privacidade, como também, limitações e preconceitos, consulte Arcade Assistant (beta).
Usar o assistente
O assistente Arcade (beta) usa linguagem natural para gerar código Arcade. Para melhores resultados, use uma linguagem clara e simples e repita as respostas recebidas.
Anotação:
O assistente é administrado no nível da organização do ArcGIS Online e pode ser desabilitado pelo seu administrador.
Para usar o assistente, faça o seguinte:
- Confirme que você está registrado em uma organização.
- Clique no iniciador de aplicativos
e selecione Map Viewer. Use o novo mapa que se abre e adicione uma camada ao mapa ou abra um mapa existente. - Abra a janela do editor de expressão de atributo no painel Estilos, Pop-ups ou Feições de rótulo.
Anotação:
Para obter informações adicionais sobre como estilizar uma camada usando uma expressão, consulte Aplicar um estilo. Para configurar pop-ups usando uma expressão, consulte Usar expressões. Para configurar rótulos usando uma expressão, consulte Aplicar rótulos.
- Clique em Assistente do Arcade
.O painel Assistente do Arcade é exibido.
- Use o assistente fazendo o seguinte:
- Clique em uma sugestão e modifique-a para criar um prompt adequado aos seus dados.
- No seu idioma preferido, insira um prompt para gerar uma expressão Arcade. .
- Clique em Gerar para realizar sua consulta.
O assistente Arcade(beta) sugere uma expressão no painel do assistente do Arcade.
Dica:
Paire sobre o botão Contexto do perfil
para visualizar onde a expressão sugerida será aplicada na configuração da camada. Paire sobre o botão Contexto da camada 
para visualizar os metadados da camada fornecidos ao assistente usado para gerar a expressão sugerida. - Para interagir com as sugestões, faça qualquer um dos seguintes:
- Clique em Adicionar ao editor para adicionar a expressão ao painel do construtor de expressões.
Dica:
Posicione o cursor no painel do construtor de expressões onde você deseja que o conteúdo seja adicionado. Por exemplo, no painel do construtor de expressões, mova o cursor e clique na frente de uma linha de código existente. Ao clicar em Adicionar ao editor no painel Assistente do Arcade, a expressão sugerida será adicionada ao painel do construtor de expressões na posição do cursor.
- Clique em Substituir todo o código no editor
para substituir qualquer conteúdo existente no painel do construtor de expressões pela expressão sugerida. - Clique em Copiar código para a área de transferência
para copiar a expressão sugerida para a área de transferência. - Para fazer ajustes no prompt, edite o prompt anterior na área de texto ou copie e cole um prompt anterior e clique em Refinar para enviar a consulta modificada.
- Para fornecer comentários sobre o assistente, clique no botão Útil
ou Inútil 
e responda à pesquisa. O comentário é usado para orientar o desenvolvimento futuro.
- Clique em Adicionar ao editor para adicionar a expressão ao painel do construtor de expressões.
Entender as melhores práticas
A seguir estão algumas diretrizes que ajudarão a gerar expressões Arcade usando o assistente Arcade (beta):
- Seja claro e conciso em sua solicitação.
- Evite ambiguidade e linguagem vaga.
- Embora não seja necessário usar nomes de campos exatos, é recomendado fornecer detalhes suficientes.
Dica:
Veja a seguir um exemplo de um prompt produtivo versus um prompt improdutivo ao criar uma expressão para configurar rótulos:
- Prompt produtivo: "Rotular cada condado com a colheita total de trigo do ano passado. Se um condado não produz trigo, não exiba um rótulo." Este prompt é produtivo, pois é claro, conciso e prático.
- Prompt improdutivo: "Escolher um rótulo para as feições." Este prompt é improdutivo, pois o assistente não escolhe como rotular as feições. O assistente apenas gera expressões com base nas instruções do autor. O autor do mapa deve decidir quais feições deseja rotular e como rotulá-las e, em seguida, pedir ao assistente para gerar uma expressão para atingir seu objetivo.
Limitações de contexto
Tenha em mente as seguintes limitações ao usar o Arcade assistant (beta):
- O assistente não é um chatbot. Ele não lembra informações que você forneceu em prompts anteriores. Ao refinar um prompt anterior, certifique-se de incluir todos os detalhes relevantes como se estivesse perguntando ao assistente pela primeira vez.
Dica:
Veja a seguir um exemplo de uma sequência produtiva de prompts versus uma sequência improdutiva de prompts:
- Prompts sequenciais produtivos:
- “Criar uma tabela HTML onde cada linha é um campo populacional.” O assistente gera uma tabela, mas sem formatação.
- “Criar uma tabela HTML onde cada linha é um campo populacional. Formate os números com vírgulas.” O contexto de criação de uma tabela HTML é mantido com o detalhe adicional de solicitar a formatação dos campos, tornando esta uma sequência produtiva de prompts.
- Prompts sequenciais improdutivos:
- “Criar uma tabela HTML onde cada linha é um campo populacional."
- “Agora formate os números com vírgulas.” O contexto de criação de uma tabela HTML agora está ausente, tornando esta uma sequência improdutiva de prompts.
- Prompts sequenciais produtivos:
- O assistente não tem conhecimento de nenhuma expressão Arcade gerada anteriormente ou de expressões existentes no editor Arcade ou no mapa da web.
Dica:
Veja a seguir um exemplo de um prompt produtivo versus um prompt improdutivo:
- Prompt produtivo: “Simplifique esta expressão: <insira a expressão aqui>.” Este prompt é produtivo, pois o usuário forneceu contexto suficiente para que o assistente pudesse gerar uma expressão.
- Prompt improdutivo: “Simplificar a expressão no editor”. Este prompt é improdutivo, pois o assistente não tem conhecimento da expressão no editor.
- O assistente não consulta seus dados. Por esse motivo, ele não tem conhecimento de valores de dados específicos presentes na camada para a qual você está gerando a expressão. Se você quiser que o assistente escreva lógica condicional com base em valores de dados, você deverá fornecê-los em seu prompt ou permitir que o modelo de linguagem grande assuma os valores.
Dica:
Veja a seguir um exemplo de um prompt produtivo versus um prompt improdutivo:
- Prompt produtivo: "Se a pontuação for acima de 100, retorne ‘bom’. Se for acima de 75, retorne ‘moderado’. Se estiver entre 20-75, retorne ‘ruim’. Se for abaixo de 20, retorne "horrível". Este prompt é produtivo, pois os valores são específicos e as categorias são definidas.
- Prompt improdutivo: “Divida o campo de pontuação em várias categorias usando divisões naturais: ‘bom’, ‘moderado’, ‘ruim’, ‘horrível’.” Este prompt é improdutivo , pois o assistente não sabe o intervalo de valores a categorizar.
- Você não pode usar o assistente para pesquisar, referenciar ou consultar outras camadas no mapa. O único contexto que o assistente tem são nomes de campos e nomes alternativos para a camada que executa a expressão. Além disso, o assistente não tem conhecimento de anexos e tabelas relacionadas que podem estar associados à camada. Por esse motivo, há suporte limitado para gerar expressões usando funções FeatureSet. Se desejar acessar dados de outras camadas, você deverá fornecer o título da camada ou o ID do item para que o assistente saiba quais informações incluir na expressão. Se essas informações não forem fornecidas, o assistente gerará um título ou ID que você precisará substituir manualmente quando a expressão gerada for adicionada ao painel do construtor de expressões.
Dica:
Veja a seguir um exemplo de um prompt produtivo versus um prompt improdutivo:
- Prompt produtivo: “Retornar o número de incidentes que ocorreram dentro dos limites do estado de Washington. Use o campo NAME na camada us_states_2000 para realizar este cálculo." Este prompt é produtivo, pois define o limite geográfico específico e a camada no mapa que deve ser usada ao gerar a expressão.
- Prompt improdutivo: “Retornar o número de incidentes que ocorreram em Washington”. Este prompt é improdutivo, pois não está claro se o estado de Washington ou Washington, D.C. é o desejado. Além disso, não está claro qual camada no mapa deve ser usada ao executar a consulta.