The ArcGIS Notebooks assistant (beta) uses artificial intelligence (AI) to write, explain, and troubleshoot Python code. The ArcGIS Notebooks assistant (beta) generates Python code that is compatible with the latest version of ArcGIS API for Python using natural language instructions.
Caution:
An organization administrator must configure assistants before you can access the ArcGIS Notebooks assistant (beta), including turning off the Block Esri apps and capabilities while they are in beta setting. You must also have the privilege to use AI assistants.
Get started
To get started with the ArcGIS Notebooks assistant (beta), complete the following steps:
- Verify that you are signed in to your organization with the Create and edit notebooks privilege.
- Follow the steps to open a notebook.
- On the top ribbon of the notebook editor, select Assistant.
- Provide a prompt to build a Python expression.
- Optionally, select Copy from active cell to reference the active notebook cell in your query.
- Select Generate to perform the query. If necessary, select Stop to cancel the request.
The response to your prompt appears in the response pane.
- Optionally, do any of the following:
- To understand what actions the suggested code completes, select the Explanation tab in the response pane.
- To modify your query, under Recent prompts, select previous prompt, and update your language.
- To place the suggested code snippet below the active cell, select Insert suggested code.
Note:
Recent prompts are only stored for the current browser session.
For optimal results, use the ArcGIS Notebooks assistant (beta) running the most current runtime environment.
Guidelines
The following guidelines can help you generate Python expressions using the ArcGIS Notebooks assistant (beta):
- Be clear and concise in your request.
- Avoid ambiguity and vague language.
- While using exact file names, field names, and other data details is not required, providing sufficient detail is recommended.
Credits
Using the ArcGIS Notebooks assistant (beta) does not consume credits. However, the results displayed may recommend a workflow that requires credits.
Feedback
To provide feedback about a specific response, click thumbs up or thumbs down to open a survey and enter your response. When you submit a survey, your feedback may be used to guide future development of Esri products and documentation.
Security and privacy
ArcGIS Notebooks assistant (beta) aligns with the following principles:
- Prompts are not used to train Esri or third-party AI models.
- Prompts are not used to improve any Esri or third-party product or service.
- Prompts are not stored or shared unless you give explicit permission, such as when you provide feedback about the assistant.
- Prompts are not used to improve the assistant for your own use.
AI transparency cards are available with more security and privacy details.
Limitations and bias
An ArcGIS Online organizational account with a Creator, Professional, or Professional Plus user type is required to access the ArcGIS Notebooks assistant (beta). Other account types, such as public accounts, are not currently supported.
The ArcGIS Notebooks assistant (beta) does not scan your notebook code, files in the workspace, or content for context.
Suggestions generated using AI can be misleading or inaccurate. To avoid potentially reinforcing any unintentional biases in the AI models used by  the ArcGIS Notebooks assistant (beta), human judgment should be applied to interpreting and acting on the assistant's outputs.
Resources
Use the following resources to learn more: