---
id: object/page/4350
type: object
title: Page 4350 "Custom Agent Setup"
summary: Page 4350 "Custom Agent Setup" in AgentDesignExperience (System.Agents.Designer.CustomAgent). 1 events. Introduced in BC29, still in BC30.
tier: official
language: en
tags:
  - page
  - agentdesignexperience
versions:
  introduced: "29"
  last_changed: null
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: c1743bb428983b3683cae690dd2d701b4967b33e90b54fb858daeb1e35767066
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/AgentDesignExperience/app/CustomAgent/Setup/CustomAgentSetup.Page.al
    title: src/Apps/W1/AgentDesignExperience/app/CustomAgent/Setup/CustomAgentSetup.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes:
    - change/bcapps/10631
    - change/bcapps/10386
object_type: page
object_id: 4350
name: Custom Agent Setup
caption: Configure agent
namespace: System.Agents.Designer.CustomAgent
app: AgentDesignExperience
extends: null
first_version: "29"
last_version: "30"
present_in:
  - "29"
  - "30"
changed_in: []
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids: []
counts:
  fields: 0
  procedures: 15
  events: 1
  subscribers: 0
  controls: 10
  actions: 2
relations:
  out: 1
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 1
  calls: 6
  called_by: 0
  implements: 0
---

# Page 4350 "Custom Agent Setup"

> Page 4350 "Custom Agent Setup" in AgentDesignExperience (System.Agents.Designer.CustomAgent). 1 events. Introduced in BC29, still in BC30.

AgentDesignExperience · System.Agents.Designer.CustomAgent · captioned "Configure agent" · BC29-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/AgentDesignExperience/app/CustomAgent/Setup/CustomAgentSetup.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | Configure agent |
| Extensible | false |
| SourceTable | Custom Agent Setup |
| PageType | ConfigurationDialog |
| ApplicationArea | All |

## Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control's own, else the bound field's (marked).

| Group | Control | Shows | ToolTip |
|---|---|---|---|
| Content | AgentSetupPart | part [Page 4310 "Agent Setup Part"](../page/4310.md) | — |
| About the agent | Name | `AgentName` | Specifies the unique user name of the agent. |
|  | Display name | `TempAgentSetupBuffer."Display Name"` | Specifies the display name of the agent. |
|  | Initials | [Initials](../table/4350.md#fields) | Specifies the initials of the agent. |
|  | Description | [Description](../table/4350.md#fields) | Specifies the description of the agent. |
| Profile (role) | Setup profile | `ProfileDisplayName` | Specifies the profile that is associated with the agent. |
| Permissions | Manage permissions | `ManagePermissionsLbl` | Defines the permissions for the agent. |
| Agent instructions | Edit instructions | `EditInstructionsLbl` | Make quick updates without leaving configuration. |
| Agent model | Model | `SelectedModelDisplayName` | Specifies the model used by the agent. Auto means the agent uses the default model. |
| Test your agent | Test agent | `TestAgentLbl` | Updates the configuration and opens the test agent page. |

## Actions

| Group | Action | ToolTip | Runs |
|---|---|---|---|
| SystemActions | Update | Apply the changes to the agent setup. |  |
|  | Cancel | Discards the changes and closes the setup page. |  |

## Events published

- `OnActivateCustomAgent(AgentUserSecurityId: Guid)` (internal)
  - subscribers: [Codeunit 4351 "Custom Agents Wizard Setup"](../codeunit/4351.md) OnActivateCustomAgent

## Procedures

14 local procedures, no public ones.

## Triggers

OnOpenPage, OnAfterGetRecord, OnAfterGetCurrRecord, OnModifyRecord, OnQueryClosePage

## Relations

- source table [Table 4350 "Custom Agent Setup"](../table/4350.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 4350 "Custom Agent Setup"](../codeunit/4350.md) (5 calls: `IsAgentConfiguredCheck → GetDefaultProfile`, `OnQueryClosePage → OpenEditInstructionsPage`, `OnQueryClosePage → UpdateAgent`, …)
- [Codeunit 4321 "Agent"](../codeunit/4321.md) (4 calls: `ApplyUserSettingsValues → SetProfile`, `InitModelDisplay → GetModelId`, `InitModelDisplay → GetModelName`, …)
- [Codeunit 4324 "Agent Setup"](../codeunit/4324.md) (1 call: `UpdateControls → GetSetupRecord`)
- [Codeunit 4362 "Agent Designer Permissions"](../codeunit/4362.md) (1 call: `OnOpenPage → VerifyCurrentUserCanCreateCustomAgents`)
- [Codeunit 7771 "Azure OpenAI"](../codeunit/7771.md) (1 call: `OnOpenPage → IsEnabled`)
- [Page extension 9204 "User Settings"](../pageextension/9204.md) (1 call: `UpdateControls → (object)`)

## Recent changes

- 2026-08-26 [#10631 Integration/main to releases 29.x 31a860b5](../../changes/bcapps/10631.md) (releases/29.x, BC29, feature)
- 2026-08-21 [#10386 [Agent Archiving] Prevent archived custom agents from being modified](../../changes/bcapps/10386.md) (main, BC30, feature)

## Across versions

- Present in: BC29-30
- Changed (declaration) in: none

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "page", object_name: "Custom Agent Setup")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.
