{"id":2939420,"date":"2025-09-22T09:52:46","date_gmt":"2025-09-22T16:52:46","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=2939420"},"modified":"2025-09-22T10:13:47","modified_gmt":"2025-09-22T17:13:47","slug":"prompt-writing-for-ai-assistants","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis\/mapping\/prompt-writing-for-ai-assistants","title":{"rendered":"Prompt writing for AI assistants"},"author":366572,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[777102,22941],"tags":[758311,770852,780823],"industry":[],"product":[421922],"class_list":["post-2939420","blog","type-blog","status-publish","format-standard","hentry","category-arcade","category-mapping","tag-ai","tag-arcgis-assistant","tag-prompt-writing","product-arcgis"],"acf":{"authors":[{"ID":366572,"user_firstname":"Emma","user_lastname":"Fazekas","nickname":"Emma Fazekas","user_nicename":"efazekas","display_name":"Emma Fazekas","user_email":"efazekas@esri.com","user_url":"","user_registered":"2024-12-23 18:48:05","user_description":"Emma Fazekas is a product engineering writer on the ArcGIS Online team at Esri's Research and Development Centre in Ottawa, Canada. She holds degrees in physical geography, GIS, and education. In her free time, Emma enjoys triathlons, snowboarding, hiking, and spending time with her dog Stella.","user_avatar":""},{"ID":353902,"user_firstname":"FNU","user_lastname":"Leann Mary Kurias","nickname":"Leann Kurias","user_nicename":"lkurias","display_name":"Leann Kurias","user_email":"lkurias@esri.com","user_url":"","user_registered":"2024-02-28 19:54:35","user_description":"Leann develops technical content for the ArcGIS Dashboards team, bringing together strong analytical expertise and creative problem-solving to support data-driven decision-making. With a Master's in Business Analytics and Economics, she is passionate about using data to drive business solutions.","user_avatar":""}],"short_description":"Prompt writing guidelines help you effectively communicate and get started with ArcGIS AI assistants.","flexible_content":[{"acf_fc_layout":"content","content":"

Prompt writing is the practice of creating clear and thoughtful instructions for an AI tool such as an ArcGIS AI assistant. These instructions, called prompts, are how you ask the tool to answer a question, write a summary, generate text, or help with a task. The way a prompt is written has a big impact on the quality of response you receive, so learning how to write good prompts will help you get better results. This article includes guidelines for prompt writing, and provides simple, practical examples to help you get started with ArcGIS AI assistants.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":2940395,"id":2940395,"title":"Writing_826x465","filename":"Writing_826x465-e1758229032900.png","filesize":48749,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/09\/Writing_826x465-e1758229032900.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis\/mapping\/prompt-writing-for-ai-assistants\/writing_826x465","alt":"Pencil and paper","author":"366572","description":"","caption":"","name":"writing_826x465","status":"inherit","uploaded_to":2939420,"date":"2025-09-18 20:27:30","modified":"2025-09-18 20:27:52","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":600,"height":338,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/09\/Writing_826x465-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/09\/Writing_826x465-e1758229032900.png","medium-width":464,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/09\/Writing_826x465-e1758229032900.png","medium_large-width":600,"medium_large-height":338,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/09\/Writing_826x465-e1758229032900.png","large-width":600,"large-height":338,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/09\/Writing_826x465-e1758229032900.png","1536x1536-width":600,"1536x1536-height":338,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/09\/Writing_826x465-e1758229032900.png","2048x2048-width":600,"2048x2048-height":338,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/09\/Writing_826x465-e1758229032900.png","card_image-width":600,"card_image-height":338,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/09\/Writing_826x465-e1758229032900.png","wide_image-width":600,"wide_image-height":338}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Prompt writing guidelines<\/strong><\/h2>\n

When creating a prompt, be sure to state your goal, provide any necessary context, and outline your formatting expectations. Consider the following guidelines when communicating with an assistant:<\/p>\n

Use clear and simple language<\/h3>\n

State clearly what you want the assistant to do and avoid using ambiguous language. Take a look at the Arcade assistant (beta)<\/a> prompt below.<\/p>\n\n\n\n
\"x\"<\/td>\nSummarize marital status in some type of table or graph that looks organized.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The prompt lacks clarity by leaving the formatting up to the assistant\u2019s interpretation instead of directly stating the desired outcome. The table or graph type, for example HTML table or bar graph, is not specified, leading to further potential misinterpretations by the assistant. The following would be a better prompt:<\/p>\n\n\n\n
\"Check<\/td>\nCreate an HTML table listing marital status. Have the first column be marital status, and the second be the number of people in each category. Format numbers with commas. Highlight the row with the highest value in orange.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Be specific<\/h3>\n

Provide enough detail when explaining a task or command to avoid generic results. Take a look at the Survey123 assistant (preview)<\/a> prompt below.<\/p>\n\n\n\n
\"x\"<\/td>\nCreate a survey to provide feedback about an event.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The prompt does not specify an event type; therefore, the assistant can only create generic questions that apply to a wide range of events. Tailored questions which provide more valuable results, such as asking about sound quality at an outdoor concert, require additional context and details. Important survey questions or topics are not mentioned in the prompt; as a result, key information might not be collected. Remember to always include sufficient detail to achieve the best results. The following would be a better prompt:<\/p>\n\n\n\n
\"Check<\/td>\nCreate a survey for participants to provide feedback about the Boston Marathon. Include questions about pre-race communication, race safety, clarity of route markings, water station locations, post-race snacks, parking, and overall satisfaction.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n"},{"acf_fc_layout":"content","content":"

Specify a presentation format<\/h3>\n

Tell the assistant how you would like the results presented by providing constraints, such as word count, and explicitly stating your desired format. Take a look at the documentation assistant (beta)<\/a> prompt below.<\/p>\n\n\n\n
\"x\"<\/td>\nCompare partnered collaboration to distributed collaboration.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The prompt clearly states a task; however, the desired presentation format is not specified. It is unclear to the assistant whether the resulting information should be provided as a list, paragraphs, chart, table, or other format. The following would be a better prompt:<\/p>\n\n\n\n
\"Check<\/td>\nCompare partnered collaboration to distributed collaboration using a maximum of 50 words. Present results as bullet points.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Specify the audience<\/h3>\n

Provide information about the intended audience, such as age, reading ability, or preferred languages, to achieve results that are better tailored to your needs. Take a look at the documentation assistant (beta)<\/a> prompt below.<\/p>\n\n\n\n
\"x\"<\/td>\nWhat is ArcGIS Instant Apps?<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The prompt does not specify the needs of the intended audience, such as result length or reading ability. In this case, the assistant does not know that the intended recipient is new to GIS and will require definitions for subject-specific terms and the use of simplified language. Without specifying the audience, the assistant might provide you with a result that is too technical and complex for your needs. The following would be a better prompt:<\/p>\n\n\n\n
\"Check<\/td>\nExplain what ArcGIS Instant Apps is to a person with minimal GIS knowledge. Use simple language. Maximum 100 words.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Iterate prompts to refine results<\/h3>\n

When communicating with an assistant, a good strategy is to write a prompt, evaluate the results, then rewrite the prompt to improve the results. You may need to experiment with multiple iterations of a prompt to get what you\u2019re looking for. Take a look at the example below.<\/p>\n\n\n\n
\"Check<\/td>\nOriginal prompt<\/strong>: Create a map of the number of preschool aged children in California.
\nFirst iteration<\/strong>: Create a map of the number of children under the age of 4 in California.
\nSecond iteration<\/strong>: Create a map with a green color ramp of the number of children under the age of 4 in California.
\nAdd further iterations if necessary.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The original prompt returned an undesired result because ambiguous language, such as preschool aged, was used. If a result is not what you envisioned, rewrite the prompt with added details and context. For example, the first iteration restates the original prompt with additional information about age. To further tailor the result, the second iteration specifies a color ramp for the map. Remember that your first prompt might not always be successful; refine your prompts to get better results.<\/p>\n

Some assistants, such as the Business Analyst assistant (preview)<\/a>, are conversational and remember content from the beginning of the session. When communicating with a conversational assistant, you do not need to rewrite previous prompts or iterations in their entirety. For example, the second iteration of the example prompt could be shortened to \u2018Switch the color ramp to green\u2019.<\/p>\n

Next steps<\/strong><\/h2>\n

These guidelines can help you begin crafting effective prompts to get the most out of an AI assistant. Try them today and experience how an AI assistant can enhance your workflow.<\/p>\n

Start with the Configure AI assistants<\/a> page to choose an assistant that interests you and learn how to get started.<\/p>\n

Learn more about AI assistants by watching the video below:<\/p>\n"},{"acf_fc_layout":"kaltura","video_id":"1_awqmivo2","time":false,"start":0,"stop":""},{"acf_fc_layout":"content","content":"

More resources<\/strong><\/h2>\n

For more detailed information and tips, check out these blog posts:<\/p>\n