Skip to main content

Configure the Hub assistant (beta)

This feature is only available in ArcGIS Online with Hub Premium.

Learn more about feature compatibility

The ArcGIS Hub assistant (beta) is an in-app productivity tool that uses generative artificial intelligence to make open data more accessible, understandable, and actionable. It is designed to help site visitors find answers to their questions using the curated, public datasets available on your Hub site.

When a user poses a question, the Hub assistant (beta) analyzes it and searches through relevant, public datasets from your site. It then provides simplified answers to help users find the information they need.

Note:

AI capabilities and assistants are in beta. Your ArcGIS Online administrator needs to configure assistants before you can access AI capabilities in ArcGIS Hub. You must also have the privilege to use AI assistants. For beta capabilities, your administrator must turn off the Block Esri apps and capabilities while they are in beta setting.

Licensing

An ArcGIS Online organizational account with a Hub Premium license is required to enable and configure the Hub assistant (beta) for a site.

Enable the Hub assistant (beta)

Site editors can enable the Hub assistant (beta) by managing a site within the Hub workspace.

To enable the Hub assistant (beta) for a site, complete the following steps:

  1. Follow the steps to manage a site in the user workspace.

  2. Click the Settings tab and click the Hub assistant (beta) pane .

  3. Under Availability, click Enable the Hub assistant (beta) to turn on the Hub assistant (beta).

  4. For Access, choose whether the Hub assistant (beta) will be available only to the site owner, the organization, or the public.

    Before deploying the Hub assistant on a site, you can test it within your organization by limiting access to a specified group of people.

    Note:

    Assistant access can be set no higher than the site access. For example, if the site access is set to the organization only, the highest sharing permission (access) on the assistant is also organization only.

    If Public is chosen, Allow unauthenticated access if public access is enabled will be turned on automatically. This setting allows site visitors to use the Hub assistant (beta) without signing in to an ArcGIS account.

    Note:

    Usage rate limits are automatically applied to anonymous public users.

  5. Turn off Allow unauthenticated access if public access is enabled if public access is enabled and you do not want anonymous users to access the Hub assistant (beta).

  6. For Group access, click Select groups and select one or more groups that will have access if necessary.

  7. Under Details, configure the following settings:

    • Title—The name of the Hub assistant (beta). The title appears in the welcome message when the Hub assistant (beta) is opened.

    • Description—Text explaining how to use the Hub assistant (beta). The text appears below the welcome message.

    • Default location—Set the default location to help the assistant complete partial addresses so that if a user adds a street address such as 15 Main Street, the assistant will first search for matching addresses in the default location.

  8. For Personality, define characteristics to determine the style and tone of the assistant's conversation.

    Provide these definitions in the form of a system prompt to guide the assistant to respond to requests in a particular way, such as Speak in a casual manner, Be upbeat and positive, or Speak at an 8th grade level.

  9. For Prompts, provide suggested prompts to display when a user initializes the assistant.

    Example prompts should be relevant to the available data in the Hub site catalog, such as When is my recycling day?, or Which park has the most trees?.

  10. For Workflows, customize the default workflows and add new ones, if needed.

    Two types of workflows can be configured: search or respond. The default search workflow option directs the assistant to look for answers using the data available on your Hub site. The two default respond workflows options include guardrails to directly respond with a preconfigured message, rather than searching the data catalog, if prompted with questions related to risk-associated behaviors. These three workflows represent a baseline best practice that can be modified, or you can add more workflows.

    Note:

    The two default respond workflows may need to be customized to reflect local information, such as emergency numbers.

  11. Click Save.

Credits

Using the Hub assistant (beta) does not consume credits while in beta.

For additional information, see the following: