The ArcGIS Notebooks assistant (beta) uses artificial intelligence (AI) to write, explain, and troubleshoot Python code. The 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 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 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 Code snippets.
- Select the Assistant tab.
- 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.
The response to your prompt appears in the response pane.
- Optionally, complete the following steps:
- 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 into notebook.
Note:
Recent prompts are only stored for the current browser session.
For optimal results, use the Notebooks assistant (beta) running the most current runtime environment.
Guidelines
The following are guidelines to help you generate Python expressions using the 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 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, and complete the survey. The feedback may be used to guide additional development of the assistant.
Security and privacy
The Notebooks assistant (beta) aligns with the following principles:
- While in beta, prompts will be stored and used by Esri to improve the software.
- Prompts are not shared.
- 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 Notebooks assistant (beta). Other account types, such as public accounts, are not currently supported.
The 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 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: