Perform an action with the ArcGIS Pro assistant (beta)
The ArcGIS Pro assistant (beta) can perform actions in an ArcGIS Pro session, such as styling a layer, zooming to content, or selecting features based on an attribute.
Action capabilities
The actions available to the assistant in ArcGIS Pro Actions mode are a limited subset of the capabilities of ArcGIS Pro. Some actions, such as zooming to a layer, are applied immediately. For requests that require running a geoprocessing tool, the assistant opens the tool with preset parameters from your current session. The assistant may ask for additional input or clarification.
Tip:
The assistant can answer questions about its capabilities. Ask the assistant to outline the available actions that it can perform.
In ArcGIS Pro Actions mode, the following capabilities are available to the assistant:
Business Analyst
Geocoding
Geoprocessing Tools and Toolboxes
Knowledge Graph
Map Analyzer
Map and Layer Management
Map Production
Packaging Capabilities
Portal Connections
Symbology and Visualization
Additional Capabilities
For more information about each capability, see Action capabilities available to the ArcGIS Pro assistant (beta).
Perform an action
To perform an action using the assistant, complete the following steps:
In the Assistant (Beta) pane, click the ArcGIS Pro Actions card, or click the menu button
, and click ArcGIS Pro Actions
.In the prompt text box at the bottom of the pane, enter a natural-language question or prompt requesting that the assistant perform an action, and click Ask the question
.For example, enter a prompt such as zoom to the cities layer or zoom to cities to zoom to a layer. Enter a prompt such as symbolize the census layer to symbolize a layer.
The assistant responds by performing the action or, if necessary, asks for clarification or more information.
Clarify your request or verify that the action was performed correctly.
Keep the following in mind when performing actions with the assistant:
As the conversation with the assistant continues, previous context is considered. This means that you can refine or supplement a request for action without explaining it again. For example, if your initial request was apply graduated color to counties using a field with population info, your follow-up request could be change the number of classes to 10. You don't need to specify the field again in this example.
When you know the tool or action you want, precise terminology achieves better results. For example, enter open the buffer tool.
In long-running conversations, if you start to see unexpected, incorrect, or unhelpful responses from the assistant, consider starting a new conversation.
Set the focus of the conversation
Optionally, you can set the focus of a conversation in ArcGIS Pro Actions mode by limiting the capabilities the assistant considers. By default, the assistant considers all available capabilities when generating responses.
To filter the available capabilities, use the assistant in ArcGIS Pro Actions mode to complete the following steps:
In the prompt text box, click the assistant capabilities button
to open the Focus tab of the Assistant Settings page.Check the capabilities you want to be accessible to the assistant, and uncheck those that it should not consider.
Check the Save for future conversations check box to persist these choices to other conversations across all of your ArcGIS Pro sessions.
Use images in a prompt
You can attach images as additional context for your questions and requests. For example, you can extract text information from the provided image or add a reference map showing the appearance you want to achieve.
Note:
Image inputs are available only in ArcGIS Pro Actions mode.
To use an image in a prompt, complete the following steps:
In a conversation in ArcGIS Pro Actions mode, click Attach Images in the prompt text box.
Add an image in one of the following ways:
Click Take a screen capture to add a screen capture.
Click Upload an image to add an image from storage.
Tip:
Alternatively, you can paste an image from the clipboard in the prompt text box.
Build custom actions
You can create custom actions for the assistant by building an add-in with ArcGIS Pro SDK. The add-in includes an assistant extension, which is a class that covers one type of functionality, such as layout creation or table editing. Each extension contains one or more assistant functions, and each function performs a single task in ArcGIS Pro.
When you submit a request in ArcGIS Pro Actions mode, the assistant uses the descriptions defined for each extension and function to determine which function to call and what values to give the function. An add-in can also override built-in extensions or individual functions to prevent the assistant from considering them when responding to a request.
For step-by-step instructions on creating an assistant extension, see ProGuide: Create a Pro Assistant Function.
Model Context Protocol connections
Model Context Protocol (MCP) connects AI applications to tools provided by other applications and services. You can use MCP with ArcGIS Pro in the following ways:
ArcGIS Pro MCP enables an external AI application to use selected ArcGIS Pro capabilities.
MCP connectors enable the assistant, in ArcGIS Pro Actions mode, to use tools from external MCP servers.
Connect an external AI application to ArcGIS Pro
To use ArcGIS Pro MCP to enable a compatible external AI application to work with your current ArcGIS Pro session, complete the following steps:
Click the menu button
, and click Assistant Settings
.On the Assistant Settings page, click the MCP tab.
On the MCP tab, click the ArcGIS Pro MCP tab.
Optionally, specify the tools to make available through the connection to your external AI application by doing the following:
Click the Available Tools drop-down arrow.
By default, all tools are available through the MCP connection.
Scroll down to the bottom, and click Unselect all.
Check the check boxes corresponding to the capabilities you want to enable.
The external application can only use the capabilities you selected.
Click the Connection Credentials drop-down arrow.
The Connector URL and Authentication Token credentials are displayed. You use these credentials to configure the connection in the external application.
Optionally, click Edit Port
to edit the port number in the Connector URL credential.Click Start.
The ArcGIS Pro MCP server is active.
Follow the external application's instructions for adding an MCP server, completing the following steps as needed:
Click Copy URL to copy the Connector URL value for use in the external application.
Click Copy Token to copy the token for use in the external application.
Tip:
You can click Show
to reveal the token, and click Refresh Token
to generate a new token.
When you make a request related to ArcGIS Pro in your external AI application, it can use the ArcGIS Pro assistant tools that you made available to complete the request.
Note:
Keep ArcGIS Pro open and the server running while using the connection. Only one ArcGIS Pro MCP server can run on a computer at a time.
Stop and change an external connection
To stop and change an external connection, complete the following steps:
Click Stop to end external access to ArcGIS Pro.
Make any changes to the available tools, server port, or authentication token.
Update the connection in your external AI application.
Note:
You can make these changes only after ending external access.
Optionally, click Start to restart the connection.
Connect the assistant to an external MCP server
To make tools from external MCP servers available to the assistant in ArcGIS Pro Actions mode, complete the following steps:
Click the menu button
, and click Assistant Settings
.On the Assistant Settings page, click the MCP tab.
On the MCP tab, click the MCP Connectors tab.
Tip:
When the assistant is in ArcGIS Pro Actions mode, you can open the MCP Connectors tab directly by clicking MCP
in the prompt text box. A round blue dot over the icon indicates that external MCP tools are active.Click Add MCP.
Provide a name for the MCP server in the MCP Name text box.
Keep the default value HTTP in the Transport text box.
Paste the server URL supplied by the server provider in the Server URL text box.
Click the Authentication Type drop-down arrow, and click the appropriate authentication type from the following list:
None—No authentication is required.
API key—Fill the Key and Value text boxes with the header names and values that the provider supplies.
OAuth—Follow the browser sign-in prompts, and provide any additional details required by the provider.
Click Connect.
The connection is activated and the available tools display in the pane.
Review the available tools and configure their permissions according to the following options:
Permission Behavior Always allow The assistant uses the tool without asking for approval. Ask every time (default) The assistant requests approval each time the tool is used. Deny The assistant cannot use the tool. To choose a single permission setting for all tools, click the Tools Permission drop-down arrow, and click the desired permission level.
Click Back
twice to return to your current conversation with the assistant.When you have a conversation with the assistant in ArcGIS Pro Actions mode, the assistant selects tools from the relevant server to complete your requests.
Manage a connector
To manage a connector, click its name on the MCP Connectors tab, and do any of the following:
Review the available tools and update their permissions.
Click Disconnect to end the active connection with the external MCP server, or click Connect to reactivate the connection.
Click Sign Out to end the OAuth session.
Click Delete to remove the connector from the list of MCP servers accessible to the assistant.
Change connection settings
To change the connection settings of a connector, complete the following steps:
Click Disconnect.
Make the needed changes.
Click Connect to reconnect to the external MCP server.