---
id: object/page/4359
type: object
title: Page 4359 "Agent New Task Message"
summary: Page 4359 "Agent New Task Message" in AgentDesignExperience (System.Agents.Designer). 2 public procedures. 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: 6186b6723483687d85b8e877390889736176f75c0caffa23fcf093228d613396
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/AgentDesignExperience/app/Interaction/AgentNewTaskMessage.Page.al
    title: src/Apps/W1/AgentDesignExperience/app/Interaction/AgentNewTaskMessage.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: page
object_id: 4359
name: Agent New Task Message
caption: Create message
namespace: System.Agents.Designer
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: 9
  events: 0
  subscribers: 0
  controls: 11
  actions: 2
relations:
  out: 0
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 0
  calls: 6
  called_by: 0
  implements: 0
---

# Page 4359 "Agent New Task Message"

> Page 4359 "Agent New Task Message" in AgentDesignExperience (System.Agents.Designer). 2 public procedures. Introduced in BC29, still in BC30.

AgentDesignExperience · System.Agents.Designer · captioned "Create message" · BC29-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/AgentDesignExperience/app/Interaction/AgentNewTaskMessage.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | Create message |
| PageType | Card |
| 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 |
|---|---|---|---|
| Task | Title | `TitleText` | Specifies the title of the task. |
|  | Save as template | `SaveAsTemplate` | Specifies whether to save this task as a template when the page is closed. |
|  | External ID | `ExternalId` | Specifies the external ID of the task. This field is used to connect to external systems, like Message ID for emails. |
|  | Include message | `IncludeMessage` | Specifies if message should be included in the task. It is possible to create tasks with no messages. |
| Message | From | `FromText` | Specifies who the message is from. |
|  | Message External ID | `MessageExternalId` | Specifies the external ID of the message. This field is used to connect to external systems, like Message ID for emails. This value allows to track the specific message ID that can be different than the one defined for the task. |
|  | Requires review | `RequiresReview` | Specifies whether the message requires review. |
|  | Sanitize message text | `SanitizeMessageText` | Specifies whether to sanitize the text of the message. |
|  | Ignore attachments | `IgnoreAttachments` | Specifies whether to ignore processing of attachments in the message. |
| MessageTextGroup | Message text | `MessageText` | Specifies the text of the message. The message is optional, it is possible to create tasks without a message. |
| Content | Attachments | part [Page 4358 "Agent Message Attachments"](../page/4358.md) | — |

## Actions

| Group | Action | ToolTip | Runs |
|---|---|---|---|
| Template | Save to template | Saves the current task and message as a template for future use. |  |
|  | Apply template | Applies a template. |  |

## Procedures

- `SetAgentTask(var NewAgentTask: Record "Agent Task")` (internal)
- `SetAgentTask(var NewAgentTask: Record "Agent Task"; CreateTask: Boolean)` (internal)

Plus 7 local procedures.

## Triggers

OnQueryClosePage, OnOpenPage

## 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 4316 "Agent Task Message Builder"](../codeunit/4316.md) (5 calls: `AddMessageToExistingTask → Create`, `AddMessageToExistingTask → SetAgentTask`, `CreateNewMessage → AddAttachment`, …)
- [Codeunit 4315 "Agent Task Builder"](../codeunit/4315.md) (3 calls: `CreateNewTask → AddTaskMessage`, `CreateNewTask → Create`, `CreateNewTask → Initialize`)
- [Codeunit 4353 "Agent Designer Environment"](../codeunit/4353.md) (1 call: `OnOpenPage → VerifyCanRunOnCurrentEnvironment`)
- [Codeunit 4361 "Agent Task Template"](../codeunit/4361.md) (1 call: `OnQueryClosePage → CreateTemplateFromTask`)
- [Codeunit 4365 "Agent Designer Utilities"](../codeunit/4365.md) (1 call: `CreateNewMessage → SanitizeContent`)
- [Page 4360 "Agent Task Template Card"](../page/4360.md) (1 call: `OnQueryClosePage → (object)`)

## 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: "Agent New Task Message")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.