---
title: "Codeunit 4417 SOA Item Selector, extension points 29"
author: "JOP-AL"
url: https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/points/
object: https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/
app: "Sales Order Agent"
major: 29
source: https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/
checked: 2026-11-20
changed: 2026-10-05
subject: "Microsoft Dynamics 365 Business Central"
license: "Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/"
---

# Codeunit 4417 SOA Item Selector, extension points 29

JOP-AL, https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/points/

7 procedures and triggers with a step in src/Apps/W1/SalesOrderAgent/app/src/ItemSearch/SOAItemSelector.Codeunit.al, in source order, read from the text, not from a run.

## SelectBestMatchingItems

[Line 39](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L39), internal.

- [51](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L51) calls `TrySelectBestMatchingItems`
- [53](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L53) calls `LogItemSelectorException`
- [58](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L58) calls `LogItemSelectorResponseFailure`

## TrySelectBestMatchingItems

[Line 67](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L67), local.

- [80](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L80) calls `GetItemSelectorSystemPrompt`
- [86](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L86) calls [Codeunit 7771 Azure OpenAI](https://jonas-paprotka.de/ref/codeunit/7771-azure-openai/) `SetAuthorization`
- [86](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L86) calls [Codeunit 7768 AOAI Deployments](https://jonas-paprotka.de/ref/codeunit/7768-aoai-deployments/) `GetGPT56CeresLatest`
- [87](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L87) calls [Codeunit 7771 Azure OpenAI](https://jonas-paprotka.de/ref/codeunit/7771-azure-openai/) `SetCopilotCapability`
- [90](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L90) calls [Codeunit 7761 AOAI Chat Completion Params](https://jonas-paprotka.de/ref/codeunit/7761-aoai-chat-completion-params/) `SetMaxTokens`
- [90](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L90) calls `MaxTokens`
- [91](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L91) calls [Codeunit 7761 AOAI Chat Completion Params](https://jonas-paprotka.de/ref/codeunit/7761-aoai-chat-completion-params/) `SetTemperature`
- [94](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L94) calls [Codeunit 7763 AOAI Chat Messages](https://jonas-paprotka.de/ref/codeunit/7763-aoai-chat-messages/) `AddTool`
- [95](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L95) calls [Codeunit 7763 AOAI Chat Messages](https://jonas-paprotka.de/ref/codeunit/7763-aoai-chat-messages/) `SetPrimarySystemMessage`
- [96](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L96) calls [Codeunit 7763 AOAI Chat Messages](https://jonas-paprotka.de/ref/codeunit/7763-aoai-chat-messages/) `AddUserMessage`
- [96](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L96) calls `BuildUserMessage`
- [99](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L99) calls [Codeunit 7771 Azure OpenAI](https://jonas-paprotka.de/ref/codeunit/7771-azure-openai/) `GenerateChatCompletion`
- [101](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L101) calls [Codeunit 7770 AOAI Operation Response](https://jonas-paprotka.de/ref/codeunit/7770-aoai-operation-response/) `IsSuccess`
- [103](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L103) calls [Codeunit 7770 AOAI Operation Response](https://jonas-paprotka.de/ref/codeunit/7770-aoai-operation-response/) `GetStatusCode`
- [107](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L107) calls [Codeunit 7770 AOAI Operation Response](https://jonas-paprotka.de/ref/codeunit/7770-aoai-operation-response/) `IsFunctionCall`
- [113](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L113) calls [Codeunit 7770 AOAI Operation Response](https://jonas-paprotka.de/ref/codeunit/7770-aoai-operation-response/) `GetFunctionResponses`
- [114](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L114) calls [Codeunit 4416 SOA Item Selector Func](https://jonas-paprotka.de/ref/codeunit/4416-soa-item-selector-func/) `Execute`
- [114](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L114) calls [Codeunit 7758 AOAI Function Response](https://jonas-paprotka.de/ref/codeunit/7758-aoai-function-response/) `GetArguments`
- [115](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L115) calls [Codeunit 4416 SOA Item Selector Func](https://jonas-paprotka.de/ref/codeunit/4416-soa-item-selector-func/) `IsSelectionResultValid`
- [116](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L116) calls [Codeunit 4416 SOA Item Selector Func](https://jonas-paprotka.de/ref/codeunit/4416-soa-item-selector-func/) `GetSelectionResultFailureCategory`
- [120](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L120) calls [Codeunit 4416 SOA Item Selector Func](https://jonas-paprotka.de/ref/codeunit/4416-soa-item-selector-func/) `GetSelectionResult`

## LogItemSelectorException

[Line 129](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L129), local.

- [136](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L136) calls [Codeunit 8703 Feature Telemetry](https://jonas-paprotka.de/ref/codeunit/8703-feature-telemetry/) `LogError`
- [136](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L136) calls [Codeunit 4400 SOA Setup](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/) `GetFeatureName`

## LogItemSelectorResponseFailure

[Line 139](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L139), local.

- [149](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L149) calls [Codeunit 8703 Feature Telemetry](https://jonas-paprotka.de/ref/codeunit/8703-feature-telemetry/) `LogError`
- [149](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L149) calls [Codeunit 4400 SOA Setup](https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/) `GetFeatureName`

## GetItemSelectorSystemPrompt

[Line 153](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L153), local.

- [157](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L157) calls [Codeunit 4598 SOA Instructions](https://jonas-paprotka.de/ref/codeunit/4598-soa-instructions/) `GetItemSelectorSystemPrompt`

## BuildUserMessage

[Line 160](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L160), local.

- [170](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L170) calls `SanitizeUntrustedText`
- [171](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L171) calls `SanitizeUntrustedText`
- [178](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L178) calls `SanitizeUntrustedText`

## SanitizeUntrustedText

[Line 182](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L182), local.

- [194](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L194) calls `ReplaceCaseInsensitive`
- [195](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L195) calls `ReplaceCaseInsensitive`
- [196](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L196) calls `ReplaceCaseInsensitive`
- [197](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L197) calls `ReplaceCaseInsensitive`
- [198](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L198) calls `ReplaceCaseInsensitive`
- [199](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L199) calls `ReplaceCaseInsensitive`
- [200](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L200) calls `ReplaceCaseInsensitive`
- [201](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L201) calls `ReplaceCaseInsensitive`
- [202](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L202) calls `ReplaceCaseInsensitive`
- [203](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L203) calls `ReplaceCaseInsensitive`
- [204](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L204) calls `ReplaceCaseInsensitive`
- [205](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L205) calls `ReplaceCaseInsensitive`
- [206](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L206) calls `ReplaceCaseInsensitive`
- [207](https://jonas-paprotka.de/ref/codeunit/4417-soa-item-selector/source/#L207) calls `ReplaceCaseInsensitive`

## Source

AL source 29: https://github.com/microsoft/BCApps, MIT, releases/29.x at 4303e5e584d3aa5d9e98cbc615525a5396ad6ed7.

JOP-AL, 2026-11-20.
