{"title":"Set up Sales Order Agent","url":"https://jonas-paprotka.de/docs/sales-order-agent-setup/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/sales-order-agent-setup, MicrosoftDocs/dynamics365smb-docs at 46907ac (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/sales-order-agent-setup","source":{"name":"Business Central application docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-docs","commit":"46907ace177f8d31deba47a2fdb57c3336e66252","date":"2026-11-19"},"checked":"2026-11-19","description":"Set up Sales Order Agent in Business Central to process sales orders from customer emails. Learn how to activate and configure the agent.","date":"2026-11-16","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Set up Sales Order Agent","slug":"set-up-sales-order-agent","at":0,"chars":32819},{"level":2,"title":"Prerequisites","slug":"prerequisites","at":273,"chars":2427},{"level":2,"title":"Turn on Sales Order Agent capability for environment","slug":"turn-on-sales-order-agent-capability-for-environment","at":2700,"chars":500},{"level":2,"title":"Configure and activate Sales Order Agent","slug":"configure-and-activate-sales-order-agent","at":3200,"chars":2312},{"level":2,"title":"Respond to inquiries<#tab/inquiries>","slug":"respond-to-inquiriestabinquiries","at":5512,"chars":1450},{"level":2,"title":"Create sales documents<#tab/documents>","slug":"create-sales-documentstabdocuments","at":6962,"chars":3108},{"level":2,"title":"Manage mailbox<#tab/mailbox>","slug":"manage-mailboxtabmailbox","at":10070,"chars":1949},{"level":2,"title":"Format outgoing message<#tab/outgoing>","slug":"format-outgoing-messagetaboutgoing","at":12019,"chars":1649},{"level":2,"title":"Start a task without receiving an email","slug":"start-a-task-without-receiving-an-email","at":13668,"chars":1974},{"level":2,"title":"Test with real customer emails","slug":"test-with-real-customer-emails","at":15642,"chars":1460},{"level":2,"title":"Configuration scenarios","slug":"configuration-scenarios","at":17102,"chars":2145},{"level":3,"title":"Control which senders the agent processes","slug":"control-which-senders-the-agent-processes","at":17275,"chars":548},{"level":3,"title":"Use multiple agent instances for different customer groups","slug":"use-multiple-agent-instances-for-different-customer-groups","at":17823,"chars":763},{"level":3,"title":"Delegate only part of the process to the agent","slug":"delegate-only-part-of-the-process-to-the-agent","at":18586,"chars":661},{"level":2,"title":"Manage agent when Copilot Credits run out","slug":"manage-agent-when-copilot-credits-run-out","at":19247,"chars":2206},{"level":3,"title":"Best practices for managing credits","slug":"best-practices-for-managing-credits","at":20012,"chars":1441},{"level":2,"title":"Manage users and agent settings","slug":"manage-users-and-agent-settings","at":21453,"chars":9952},{"level":3,"title":"Understand permissions and access","slug":"understand-permissions-and-access","at":21707,"chars":1530},{"level":3,"title":"Add users to the agent","slug":"add-users-to-the-agent","at":23237,"chars":2063},{"level":4,"title":"From Configure Sales Order Agent<#tab/soaconfig>","slug":"from-configure-sales-order-agenttabsoaconfig","at":23556,"chars":1073},{"level":4,"title":"From the Sales Order Agent card page<#tab/soapage>","slug":"from-the-sales-order-agent-card-pagetabsoapage","at":24629,"chars":671},{"level":3,"title":"Change agent language, region, and other settings","slug":"change-agent-language-region-and-other-settings","at":25300,"chars":1426},{"level":3,"title":"Review and customize the agent's profile","slug":"review-and-customize-the-agents-profile","at":26726,"chars":1765},{"level":3,"title":"Manage permission sets for the agent account","slug":"manage-permission-sets-for-the-agent-account","at":28491,"chars":1267},{"level":3,"title":"Resolve \"The agent needs additional permissions to continue\"","slug":"resolve-the-agent-needs-additional-permissions-to-continue","at":29758,"chars":1647},{"level":2,"title":"Diagnose agent tasks and steps","slug":"diagnose-agent-tasks-and-steps","at":31405,"chars":1007},{"level":2,"title":"Next steps","slug":"next-steps","at":32412,"chars":231},{"level":2,"title":"Related information","slug":"related-information","at":32643,"chars":176}],"text":"# Set up Sales Order Agent\nThe Sales Order Agent in Business Central automates processing sales orders from customer email requests. This article explains how to activate and configure the agent.\nLearn more about the agent in Sales Order Agent overview<sales-order-agent>.\n## Prerequisites\nBefore configuring and activating Sales Order Agent, ensure the following prerequisites are met:\n You have the required permissions:\n   To create a Sales Order Agent instance, you need the Configure All Agents system permission (ID 9665).\n   To manage an existing agent, you need the Configure All Agents system permission or be listed in the agent's user access list with Can Configure selected.\n  Learn more about #understand-permissions-and-access.\n To process customer requests automatically from email, set up a Microsoft 365 user and a shared mailbox. You don't need to connect a mailbox if you only start tasks manually. See Set up email<admin-how-setup-email>.\n> IMPORTANT\n> To configure email monitoring, you need Read and manage (Full Access) and Send as permission on the mailbox, unless it's your personal mailbox. As an Exchange admin, delegate these permissions to all users who need to configure email monitoring. See Use the Exchange admin center to edit shared mailbox delegation<https://learn.microsoft.com/microsoft-365/admin/email/create-a-shared-mailbox#use-the-eac-to-edit-shared-mailbox-delegation>.\n> When a user activates the agent, it runs as a background task in the context of that user and needs access to the shared mailbox to process emails. It might take a few hours for Exchange to propagate the permissions to the selected users.\n Billing for agent capabilities is configured for the Business Central environment in the Business Central admin center.\n  Agents use Copilot Credits when a user runs it, which your company is charged for. See Manage consumption-based billing<dev-itpro/administration/tenant-admin-center-manage-consumption-billing>.\n (Sandbox environments only) The Allow HttpClient Requests toggle in the Sales Order Agent extension settings is turned on.\n  Open the Extension management<https://businesscentral.dynamics.com/?page=2500> page, select Sales Order Agent, and then turn on the Allow HttpClient Requests toggle.\n> TIP\n> Before you activate the agent, review your contact list to make sure that the customer contacts have accurate email addresses in the E-Mail field. The agent relies on email matching to identify customers. Contacts without email addresses, or with outdated addresses, require manual intervention for each incoming request. See Identifying customers/contacts<sales-order-agent#identifying-customerscontacts-and-related-documents>.\n## Turn on Sales Order Agent capability for environment\nThe agent capability is on if the Sales Order Agent icon appears in the top navigation menu of the role center.\nIf the icon isn't present, turn it on from the Copilot & agent capabilities page, like other Copilot features in Business Central. Sales Order Agent is listed under Generally available. See Configure Copilot and AI agent capabilities<enable-ai>.\nNext, configure, and then activate the agent so it can process customer sales orders.\n## Configure and activate Sales Order Agent\nConfigure and activate Sales Order Agent for your company. You can set up multiple Sales Order Agent instances per company, each with its own email monitoring and processing rules. Each instance tracks its own performance metrics independently.\nArchived Sales Order Agent configurations are read-only and don't count toward the number of active agent instances. You can keep an archived configuration for reference without preventing the creation of another active instance.\n1. In the navigation bar at the upper right of the role center, select Sales Order Agent > Activate.\n1. On the Configure the Copilot agent page, turn on the Active toggle.\n ![Shows the Sales Order Agent configuration page]\n1. Select Language and region to specify the default language, region, and time zone the agent uses for:\n  Outgoing emails to customers or contacts. If a customer or contact card has a language specified, the agent uses that language instead of the default.\n  Messages about tasks to users in the Tasks pane.\n When you first configure the agent, it uses the same settings as your workspace (under Settings > My Settings). You can change the language later from the Sales Order Agent card page. Learn more about these settings in #change-agent-language-region-and-other-settings.\n1. Select Manage user access to specify the users who can work with the agent and whether they can also configure it. You can add more users now or later. See #add-users-to-the-agent.\n1. If you want to change the agent's display name in the task pane and icon initials, set the Display name and Initials fields. These fields can't be blank.\n1. Configure email monitoring if you want the agent to create tasks from incoming email. Turn on the Monitor and process emails toggle, and then select the mailbox and folder to monitor. If you only start tasks manually, leave this setting turned off.\n1. On the right side of the page, select the Go to next card arrow to configure more options that determine how the agent behaves.\n The options are spread across multiple cards. Use the Go to next card (Ctrl+Right arrow) and Go to previous card (Ctrl+Left arrow) arrows to go back and forth between the cards and set the various options. Each tab that follows describes a group of related options:\n## Respond to inquiries<#tab/inquiries>\nThese options specify how the agent engages in conversations related to price and availability of products and services.\nOption|Description|Default\n-|-|-\nMessages from already registered senders|Specifies the type of review required for incoming messages from already registered senders.|First message in a conversation\nMessages from unregistered senders|Specifies the type of review required for incoming messages from unregistered senders.|All\nSelect only available items|Specifies whether the agent considers item availability when searching for the customer's requested items.<br><br>When on, the agent checks inventory to determine whether the customer's requested item quantity is available based on the requested delivery date, location, unit of measure, and variant. If there aren't enough items, the agent prepares a reply that explains the requested items aren't available.<br><br>When off, the agent ignores availability signals and doesn't block processing because of stock levels. The agent can create quotes for quantities that aren't available, which can result in negative availability.<br><br>See sales-order-agent-item-availability.|Off\nInclude capable to promise|Specifies whether the agent includes in the search results items that are currently unavailable but can be ordered for a later shipment date.<br><br>See sales-order-agent#calculating-delivery-dates-using-capable-to-promise.|Off\n## Create sales documents<#tab/documents>\nThese options specify how you interact with the agent to create sales quotes and make orders from quotes in response to the incoming requests.\nThe agent always creates a sales quote as the first step. Sales quotes have no impact on planning, reservations, availability, or cash flow, which makes them a safe intermediate document for AI-assisted processing. Depending on your configuration, the quote can be sent to the customer for review, converted directly into a sales order, or both. The following table shows how the main settings interact:\nSend quotes for confirmation|Make orders from quotes|What happens\n-|-|-\nOn|On|The agent sends the quote to the customer for review. After the customer confirms the quote, the agent converts it into a sales order. This is the default behavior.\nOn|Off|The agent sends the quote to the customer for review. The quote stays as a quote, and you must convert it to an order manually.\nOff|On|The agent creates the quote internally and immediately converts it to a sales order. The customer only receives the order, never the quote.\nOff|Off|The agent creates the quote but doesn't send it to the customer and doesn't convert it into an order automatically. You handle any customer communication and order creation manually.\n\nOption|Description|Default\n-|-|-\nReview quotes when created and updated|When on, the agent adds a review step for a Business Central user to review and confirm the sales quote before creating an outgoing email with the quote details and attachment. <br><br>When off, the agent creates or modifies sales quotes as requested and then automatically proceeds with creating an outgoing email with the quote as an attachment. The user must review and confirm the email before the agent sends it to the customer.|Off\nSend quotes for confirmation|When on, the agent sends the sales quote to the customer as a PDF attachment and waits for the customer to confirm or request changes before proceeding.<br><br>When off and Make orders from quotes is on, the agent skips the quote stage from the customer's perspective and converts the quote to a sales order immediately. The customer only receives the order.|On\nMake orders from quotes|When on, the agent converts sales quotes into orders. If Send quotes for confirmation is also on, conversion happens after the customer agrees to the quote via email and a Business Central user confirms the email. If Send quotes for confirmation is off, the agent converts the quote to an order immediately without sending the quote to the customer.<br><br>When off, you have to create the order manually.|On\nReview orders when created and updated|When on, the agent adds a review step for a Business Central user to review and confirm the sales order before creating an outgoing email with the order details and attachment. <br><br>When off, the agent creates the sales order as requested and then automatically proceeds with creating an outgoing email with the order as an attachment. The user must review and confirm the order before the agent sends it to the customer.|Off\n## Manage mailbox<#tab/mailbox>\nUse these options to configure the email mailbox the agent monitors for incoming emails and how it handles emails.\nOption|Description|Default\n-|-|-\nAccount|Specifies the email account the agent monitors when the Monitor and process emails toggle is turned on. The email account must be a Microsoft 365 type (user mailbox or shared mailbox) in your organization. See Set up email<admin-how-setup-email>.|None\nFolder|Specifies the mailbox folder that the agent monitors when the Monitor and process emails toggle is turned on. If you don't select a folder, the agent monitors the Inbox. You need Read and manage (Full Access) permission on the mailbox to set this option. See Use the Exchange admin center to edit shared mailbox delegation<https://learn.microsoft.com/microsoft-365/admin/email/create-a-shared-mailbox#use-the-eac-to-edit-shared-mailbox-delegation>|Inbox\nMark email as read|Specifies whether the agent marks processed emails as read in the mailbox. When enabled, team members can quickly identify the messages the agent handled.|On\nAnalyze attachments|Specifies whether the agent analyzes attachments on incoming emails for request information. The agent reads order details directly from supported PDF, PNG, and JPG files. PDF attachments can be up to 50 pages. A cumulative content limit of approximately 150,000 characters applies across all attachments in a single email. If the agent can't process one attachment, it continues with the other supported attachments. The Attachments page explains why the agent skipped a file. For example, a file might exceed the page count, cumulative content, or attachment count limit, or use an unsupported format.|Enabled\nDaily email limit|Specifies how many incoming emails per day the agent can handle. The agent issues an alert when the limit is reached. The emails received after the daily limit is exceeded are automatically processed on the next day.|100\n## Format outgoing message<#tab/outgoing>\nInstead of the generic default signature on emails the agent creates, add a custom signature by following these steps:\n1. Select the Include a custom signature in the replies checkbox.\n1. Select the Edit signature link.\n1. In the Edit mail signature window, type or paste the text you want the agent to use as the signature on emails.\n Use the toolbar along the bottom of the window to format the text, such as changing the font and font color or adding an image or link.\n1. Select OK when done.\n To turn off the custom signature and use the default again, clear the Include a custom signature in the replies checkbox.\n1. Select Update to complete the setup.\nThe Sales Order Agent icon changes to ![Shows the Sales Order Agent icon after configured], indicating the agent is active and ready to process tasks.\nWhen Sales Order Agent is active and email monitoring is turned on, a scheduled task periodically monitors the configured mailbox folder. When it finds a new message that it hasn't processed, Sales Order Agent imports the message into Business Central and verifies whether there's already a task for the mail thread. If a task for the thread already exists, Sales Order Agent incorporates the new message into the existing task. Otherwise, it creates a new task for the message.\n> NOTE\n> The ![Shows the Sales Order Agent icon when the agent is configured but not active] icon indicates the agent is configured but isn't active. To activate the agent, choose the icon, and then choose the Configure Sales Order Agent action to reopen the configuration page. From there, turn on the Active toggle.\n## Start a task without receiving an email\nYou can start a Sales Order Agent task manually from the Tasks pane or the Try it out section on the configuration page. You don't need to connect a mailbox or turn on email monitoring. The agent applies the same processing and review rules that it uses for requests received by email.\nTo start a task from the Tasks pane, open it for Sales Order Agent, choose New, and then continue with step 2 in the following procedure.\n1. On the Configure Sales Order Agent page, choose Create task for the agent in the Try it out section.\n1. On the Create task page, choose Contact or Customer in the Sender field.\n1. In Sender's email, select a sender or enter a valid email address.\n1. Enter the request in the Message text field.\n1. To attach supporting files, under Attachments, choose Add.\n1. Choose Create.\nTo get started quickly, choose the Use sample message link. The link fills in the page with one of two sample messages:\n A text-only message that references items from your item catalog.\n A message with a sample purchase order attachment generated as a PDF using your actual item data.\nIf the agent isn't enabled yet, you're prompted to enable it automatically when creating a task. This flow doesn't use email monitoring, so the agent only processes your test task.\n> NOTE\n> Sales Order Agent doesn't support New from file. To include supporting files, select New, and then add the files under Attachments on the Create task page.\n> The sample messages use real data from your environment. If you select a sender, the agent picks the top items by shipment frequency for that customer. Otherwise, it selects items with positive projected availability. Quantities are randomized between 1 and 10, capped at the available balance. The sample purchase order attachment is rendered from a Word template using your company information and the selected items, so you can use this feature on almost any environment with inventory data.\n## Test with real customer emails\nYou can forward, copy, or move a customer email that was originally delivered to another mailbox into the folder that the agent monitors. The method you choose affects how the agent identifies the sender:\n Forward the message: The agent uses your email address as the sender, rather than the original customer's address. If your address isn't registered on a contact, the agent applies the configured review setting for messages from unregistered senders. During an incoming-message review, you can create a contact, select another contact for this message only, or associate your address with another contact for future messages.\n Copy or move the message: Depending on the Outlook client and the method you use, copying or moving the original message can preserve the customer's address as the sender. Verify that the message in the monitored folder still shows the customer's email address in the From field.\nThe agent retrieves messages based on their received date and time in Microsoft 365, not when they were copied or moved into the monitored folder. It processes messages from the agent's activation date. Therefore, copying or moving a message received before that date might not make it eligible for processing. Forwarding creates a new message with a new received date and time.\nAfter the message reaches the monitored folder, wait for the agent's next scheduled run. You don't need to mark the message as unread.\n## Configuration scenarios\nThe following scenarios illustrate how you can combine multiple agent instances, folders, and processing rules to match different business needs.\n### Control which senders the agent processes\nThe agent processes all emails that arrive in the monitored folder. To limit processing to approved senders, create a dedicated subfolder (for example, Sales Requests) in the monitored mailbox and point the agent to that folder. Then set up Outlook rules that automatically move emails from approved senders into this folder. Emails from unknown or unapproved senders stay in the inbox and the agent never sees them. This approach gives you a sender allow-list without any changes in Business Central.\n### Use multiple agent instances for different customer groups\nYou can create multiple Sales Order Agent instances in the same company, each monitoring a different mailbox or folder and using different processing rules. For example:\n Instance 1: Shared team inbox. Monitors a shared mailbox (`sales@contoso.com`) with all review steps enabled and quotes sent for customer confirmation.\n Instance 2: Personal inbox for trusted customers. Monitors a subfolder on a salesperson's personal mailbox. The Send quotes for confirmation toggle is turned off so the agent converts quotes directly into orders. The salesperson's individual email signature is used.\nEach instance has its own display name and initials, so users can distinguish agent tasks in the Tasks pane.\n### Delegate only part of the process to the agent\nIf your pricing or discount logic requires manual steps that the agent can't perform, configure the agent to stop after creating the quote:\n1. Turn on Review quotes when created and updated.\n1. Turn off Send quotes for confirmation.\nWith this configuration, the agent reads the email, identifies items, checks availability, and creates the sales quote. It then pauses and asks a Business Central user to review the quote. The user can apply custom pricing, add discounts, or populate fields that the agent doesn't handle. After the user finishes, they can send the quote manually or resume the agent workflow.\n## Manage agent when Copilot Credits run out\nSales Order Agent requires Copilot Credits to process incoming emails. When your organization's Copilot Credit quota is depleted, the agent stops retrieving and processing new emails from the monitored mailbox. However, the agent remains active and continues to run its scheduled task and sends any pending reply emails that were already prepared.\nWhen credits become available again (for example, at the start of a new billing period or when you purchase more capacity), the agent automatically resumes processing. It picks up unprocessed emails that accumulated in the mailbox while credits were unavailable. Depending on the volume of emails, this restart can quickly consume a large portion of your renewed credits.\n### Best practices for managing credits\n Deactivate the agent if you don't want automatic resumption. If you're trying out the agent or running on limited free credits, turn off the agent before credits run out. Turning off the agent prevents it from automatically processing a backlog of emails when credits renew. To turn off the agent, select Sales Order Agent > Configure Sales Order Agent, and then turn off the Active toggle.\n Use the daily email limit to control consumption. Set the Daily email limit on the Manage mailbox configuration card to cap how many emails the agent processes per day. This setting helps prevent the agent from consuming all credits in a short time, especially after a period of inactivity.\n Monitor your credit usage. Check your Copilot Credit capacity and usage in the Power Platform admin center and stay ahead of quota limits. See Manage consumption-based billing<dev-itpro/administration/tenant-admin-center-manage-consumption-billing>.\n Manage unprocessed emails before you reactivate the agent. Consider clearing or archiving old emails from the monitored mailbox that no longer need a response so that the agent doesn't process stale requests.\n> NOTE\n> When you reactivate the agent after deactivating it, the agent processes emails from the mailbox starting from when it was deactivated. If you don't want the agent to process older emails, clear them from the monitored folder before reactivating.\n## Manage users and agent settings\nAfter setup, you can control who works with each agent instance and who can change its configuration. You can also change the agent's language and region settings and manage the permission sets assigned to its account.\n### Understand permissions and access\nTo work with or configure an agent, a user needs the relevant system permission and access to the specific agent:\n To create a Sales Order Agent instance, a user needs the Configure All Agents system permission (ID 9665).\n To configure an existing agent, a user needs the Configure All Agents permission or must be listed in that agent's user access list with Can Configure selected.\n To work with an agent's tasks in the Copilot pane, a user needs the Manage Agent Tasks system permission (ID 9670) and must be listed in that agent's user access list.\nThe following permission sets and license entitlements provide access to agent functionality:\n The AGENT - ADMIN permission set grants the Configure All Agents permission. Assign this permission set to a user who needs to create agent instances or configure any agent in the environment. The broader SECURITY and SUPER permission sets also grant this permission. To follow the principle of least privilege, use AGENT - ADMIN unless the user needs broader administrative access.\n The D365 Agent permission set grants the Manage Agent Tasks permission and access to the virtual tables used by agents. The D365 Basic permission set includes D365 Agent.\n Essential and Premium license entitlements include the Manage Agent Tasks permission.\n All current Business Central license entitlements include the Configure All Agents permission. A license makes the permission available, but users still need an assigned permission set that grants it.\n### Add users to the agent\nA user who can configure an agent can add other users to its access list. For each user, you can allow them to work with the agent's tasks only, or select Can Configure to also let them change the agent's configuration and manage its access list.\nThere are two ways to add users to an agent:\n#### From Configure Sales Order Agent<#tab/soaconfig>\n1. Open the Configure Sales Order Agent page by selecting ![Shows the Sales Order Agent icon after configured] Sales Order Agent > ![Shows the configuration icon for Sales Order Agent] Configure.\n1. Turn off the Active toggle.\n1. Select Manage user access.\n1. On the Select users that can manage or interact with the Agent page, complete the following steps:\n  To add a user, select an empty line, select the User Name field, then select the user from the list.\n  To give a user permission to configure Sales Order Agent, select the Can Configure checkbox. <br><br> The Can Configure setting defines whether a user has access to update the agent configuration (for example, updating the designated mailbox, activating and deactivating the agent, and other settings) or only to work with the agent tasks (for example, reviewing and confirming agent steps).\n  To remove a user's access to the agent, select ![Shows the icon to show more option on a field] Show more options next to the user name, and then select Delete.\n#### From the Sales Order Agent card page<#tab/soapage>\n1. To open the Sales Order Agent card page, search (Alt+Q) for Agents, and then select the Sales Order Agent account you want to manage.\n1. Set State to Disabled to deactivate the agent.\n1. In the User access section, you can do the following steps:\n  To add a user, select an empty line, select the User Name field, and then select the user from the list.\n  To give a user permission to configure Sales Order Agent, select the Can Configure checkbox.\n  To remove a user's access to the agent, select ![Shows the icon to show more option on a field] Show more options next to the user name, and then select Delete.\n### Change agent language, region, and other settings\nThe agent is validated and supported in the following languages: Danish, English, English (Canada), English (New Zealand), English (Australia), English (United Kingdom), English (United States), French, French (Canada), German, Italian, Portuguese (Brazil), and Spanish. While you can use it in other languages, it might not function as intended. Language quality might vary based on the user's interaction or system settings, which might affect accuracy and the user experience.\n1. To open the Sales Order Agent card page, search (Alt+Q) for Agents, and then select the Sales Order Agent account you want to manage.\n1. Select Agent User Settings and set the following fields:\n Field|Description\n -|-\n Profile (Role)|Specifies the role that defines the agent's home page and the UI elements available to the agent.\n Region|Specifies the regional format used by the agent for dates, times, and numbers in outgoing emails and task details.\n Language|Specifies the language the agent uses for generated text in:<ul><li>Outgoing email messages to customers or contacts. If a customer or contact card has a language specified, the agent uses that language instead of the default.</li><li>Task details and descriptions in the agent Tasks pane and log.</li></ul>\n Time zone|Specifies the time zone used by the agent when displaying and processing date and time in tasks details.\n### Review and customize the agent's profile\nThe agent uses the UI elements available in its assigned profile. It doesn't use page personalizations made by people who review its tasks. If an extension adds fields or actions to a page, review the agent's profile to verify that those elements are available to the agent.\nYou need the D365 Profile Mgt. permission set or equivalent permissions to customize profiles. Profile customization applies to all users and agent accounts assigned to that profile. To isolate changes for a specific agent, admin-users-profiles-roles#copy-a-profile, customize the copy, and then assign it to the agent.\n1. Select Search (Alt+Q) in the upper-right corner, enter Agents, and then choose the related link.\n1. Choose the Sales Order Agent account you want to manage.\n1. Choose the Agent User Settings action, and make a note of the profile in the Profile (Role) field.\n1. Select Search (Alt+Q) in the upper-right corner, enter Profiles (Roles), and then choose the related link.\n1. Choose the profile, choose the Edit action, and then choose the Customize pages action.\n Business Central opens a new browser tab that shows the pages as defined by the selected profile.\n1. Go to the relevant page, such as Sales Quote, and verify that the fields and actions the agent needs are available. Use Ctrl+click to open highlighted actions while customization mode is active. Add or show elements as needed, and then choose Done.\n1. Verify that the agent also has the permission sets required by the extension. See #manage-permission-sets-for-the-agent-account.\n1. Test the customized profile before using it with customer requests.\nTo learn more about the customization tools, go to Customize pages for profiles<ui-personalization-manage>.\n### Manage permission sets for the agent account\nThe Sales Order Agent has a user account in Business Central, similar to other users, which defines the permissions the agent has on objects and data. To access this account, search for and open the Agents page, and then select the Sales Order Agent account you want to manage. The first account created for a company is named SALES ORDER AGENT - [COMPANY]. Additional accounts are named SALES ORDER AGENT - [COMPANY] 2, SALES ORDER AGENT - [COMPANY] 3, and so on.\nThe Agent Permission Sets section lists the permission sets currently assigned to the agent. By default, the Sales Order Agent account has the SOA - EDIT permission set. This set grants access only to the objects and data necessary for handling sales quote requests. To add or remove permission sets, select Edit agent permissions.\nYou can't modify the SOA - EDIT permission set directly, because it's a system permission set. However, you can create a copy of the SOA - EDIT permission set, modify the copy to suit your needs, and then assign it to the agent, along with any other permission sets.\nBefore you can add or delete permission sets applied to the agent, change the State to disabled. When you're done making changes, set it back to Enabled.\n### Resolve \"The agent needs additional permissions to continue\"\nSales Order Agent runs under its own user account and doesn't inherit permissions from the person reviewing the task. Installed extensions can add logic or UI elements to standard pages that the agent uses, so the agent account might need permission sets provided by those extensions.\nIf a task displays The agent needs additional permissions to continue:\n1. Expand the error details and note the extension name, object type, object ID, and required access.\n1. Search for and open the Permissions Overview page.\n1. Filter by the extension named in the error. When available, also filter by Object Type and Object ID to find permission sets that grant the required access.\n1. Review the matching permission sets and note the narrowest permission sets that provide the required access.\n1. Search for and open the Agents page, and then select the Sales Order Agent account.\n1. Change State to Disabled.\n1. Select Edit agent permissions. In the Permission Set field, select the narrowest permission set that you identified and that is available in the lookup.\n1. Select OK to save the assignment and return to the Sales Order Agent card.\n1. Select Configure. On the Configure Sales Order Agent page, turn on the Active toggle, and then select Update.\n1. Retry the task.\nIf none of the permission sets you identified are available in the Permission Set lookup, contact the extension publisher. The publisher might need to recommend an existing assignable permission set or provide one that supports agent scenarios.\nSee ui-define-granular-permissions#get-an-overview-of-all-permissions.\n## Diagnose agent tasks and steps\nAdministrators can use the Agents page to inspect Sales Order Agent tasks, completed steps, messages, and detailed log entries. This information can help you identify where a task stopped and what information the agent used.\n1. Search for and open the Agents page.\n1. Select the Sales Order Agent account you want to inspect, and then choose View tasks.\n1. On the Agent Tasks page, use one of the following options:\n  Select a linked Task ID to open an active task.\n  Drill into Steps Done to inspect the execution steps.\n  Choose View log entries to open the Agent Task Log page. Select an entry, and then choose View details.\nYou don't need the Agent - Diagnostics permission set to view tasks and ordinary log details. Assign it to administrators who need to view the serialized page snapshot under What the agent saw in the log entry details.\nFor information about reviewing task timelines and assisting an agent, see Supervise agent activities<supervise-agent-tasks>.\n## Next steps\n Process sales quotes and orders with Sales Order Agent<sales-order-agent-process>\n (Optional) Configure text search language<admin-optimize-text-search-language> to optimize item lookups in multilingual environments\n## Related information\nSales Order Agent overview<sales-order-agent>\nFAQ for Sales Order Agent<faqs-sales-order-taker-agent>\nConfigure Copilot and agent capabilities<enable-ai>"}