--- title: "AI Agents Settings" slug: "ai-agents-settings" description: "Covers configuring AI Agents Settings: shared API Endpoints with secure headers for API Call Actions, plus the Shopping Agent Product Details Widget." updated: 2026-07-20T16:28:18Z published: 2026-07-20T16:28:18Z canonical: "academy.insiderone.com/ai-agents-settings" --- > ## Documentation Index > Fetch the complete documentation index at: https://academy.insiderone.com/llms.txt > Use this file to discover all available pages before exploring further. # AI Agents Settings The AI Agents Settings page lets you configure reusable **API Endpoints** for the API Call Actions of your [Support](/v1/docs/support-agent-overview) and [Shopping Agents](/v1/docs/shopping-agent-overview), and customize the **Product Details Widget** for [Shopping Agents](/v1/docs/shopping-agent-overview). To access AI Agents Settings page, navigate to **InOne** > **Agent One** > **AI Agents** and click **Settings**. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-0JTGC051.png) In the Settings page, you will see two tabs: - [API Endpoints](/v1/docs/ai-agents-settings-2#api-endpoints) - [Product Details Widget](/v1/docs/ai-agents-settings-2#product-details-widget) ## API Endpoints API Endpoints let you centrally manage the base URLs and authentication headers used by your **AI Agents** when calling external services. Once configured, you can reuse them across the **API Call Actions** of all your agents. Values you mark as sensitive information, such as API keys and tokens, are stored securely and displayed as masked values throughout the platform. > [!WARNING] > Admin users create, edit, delete, and test API Endpoints; other users can view the list, with sensitive values masked and management actions disabled. > [!NOTE] > API Endpoints are defined per account and shared by all your AI Agents (Support and Shopping Agents). 1. To define an endpoint, click **Create API Endpoint**. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-X3QUHNBH.png) 1. Name your **API Endpoint** and enter its **API Endpoint URL**. 2. The endpoint name is used only within the platform. The API Endpoint URL should contain only the base URL (for example, `https://api.yourcompany.com`). Add paths and dynamic parameters later in the API Call Action. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-TIB952MD.png) 3. Click **Add Header** to add more rows. Headers include Key-value pairs sent with every request that uses this endpoint, typically authentication credentials such as `Authorization: Bearer <token>` or an api-key. `Content-Type: application/json` is included by default. 4. Select **Mark as Sensitive Information** for each header that contains a credential or other sensitive value. Marked values are displayed masked and can't be viewed in full again on the platform; to change one, re-enter the value.![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-433KWUN2.png) 5. Click the **Create** button. > [!NOTE] > If one or more header values aren't marked as sensitive information, a confirmation asks you to verify that these values will remain visible before the endpoint is created. > [!NOTE] > Sensitive values are masked for every user on the platform once saved; they are only used when your agent sends the actual request. Once you create the endpoint, you can perform these actions: ### See Endpoint details Click **See Details** on an endpoint to review its URL and headers; sensitive values stay masked, and the AI Agent Details table, which lists the AI Agents and the API Call Actions using this endpoint, with links to each agent. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-TZVW0PVN.png) ### Edit an API Endpoint Click **Edit** on an endpoint to update its name, URL, and headers. Masked values remain masked while editing; re-enter a value to replace it or to change its sensitivity. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-BIRK6923.png) ### Delete an API Endpoint Click **Delete** on an endpoint. Deleting is permanent and can't be undone. API Endpoints used by AI Agents in Active status can't be deleted; **update** the API Call Action of those agents to use a different endpoint first. The delete panel lists the agents using the endpoint so you can check them before you proceed. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-WUQCIZPF.png) ## Product Details Widget The Product Details Widget tab lets you configure how product recommendations are presented to customers in your Shopping Agent. > [!NOTE] > The Product Details Widget is a [Shopping Agent](/v1/docs/shopping-agent-overview) feature and is unvailable for Support Agents. > [!NOTE] > Only users with the **Admin** or **Editor** role can configure these settings. - **Enable Product Details Widget**: Turns the Product Details Widget **on** or **off** for the selected agent. When enabled, the agent can display product information in a dedicated widget during conversations. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-8E4I2CJ1.png) - **Product Attribute for Description**: Selects the product attribute used as the description within the widget. By default, the predefined description field is used, but you can choose a custom product attribute if your catalog stores descriptions elsewhere. - **Product Attribute Mapping**: Defines which product attributes are displayed in the widget and how they are labeled. You can select attributes such as price, size, or material, and assign customer-friendly labels regardless of the original attribute names in your catalog. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-FW9889JH.png) > [!NOTE] > For example, the catalog attribute `size123` can be displayed as `Size`. Customers see the mapped label instead of the original attribute name. ### Widget text customization The following fields let you customize the text displayed in the Product Details Widget to match your brand and preferred language. - **Product Details Widget Header**: Specifies the title displayed at the top of the widget. - **Add to Cart Button Text**: Specifies the label displayed on the **Add to Cart** button. - **Product Link Button Text**: Specifies the label displayed on the button that directs customers to the product page. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-05MPBVFC.png) ### Translation If you support multiple languages, you can enable automatic translation for the Product Details Widget. A **Translate** button appears within the widget, allowing customers to view its content in their preferred language. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-M33XAGGK.png) Translation applies to: - Product descriptions - Attribute labels - Button text - Widget headers - All other visible text within the widget After configuring the widget, click **Save** to apply your changes. ## Related - [Create and Configure the Support Agent](/create-and-configure-the-support-agent.md) - [Create and Configure the Shopping Agent](/create-and-configure-the-shopping-agent.md)