{"title":"Codeunit 4399 SOA Annotation, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/4399-soa-annotation/points/","author":"JOP-AL","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/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-11-14","object":{"type":"codeunit","id":4399,"name":"SOA Annotation","app":"Sales Order Agent","url":"https://jonas-paprotka.de/ref/codeunit/4399-soa-annotation/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/4399-soa-annotation/source/","path":"src/Apps/W1/SalesOrderAgent/app/src/Integration/SOAAnnotation.Codeunit.al","commit":"4303e5e584d3aa5d9e98cbc615525a5396ad6ed7","lines":"a line is <source url>#L<line>"},"steps":{"event":"[line, \"event\", name, handled]: raises an event of this object; handled 1 when it has an IsHandled parameter","call":"[line, \"call\", name, arguments]: calls a procedure of this object","ext":"[line, \"ext\", type, id, name, arguments]: calls a procedure of another object, through a variable declared with that type","write":"[line, \"write\", table id, method, 1 when called with true]: Insert, Modify, ModifyAll, Delete, DeleteAll or Rename","validate":"[line, \"validate\", table id, field name]","run":"[line, \"run\", type, id]: Codeunit.Run, Page.Run, Report.Run and their kin"},"objects":{"codeunit:4587":{"name":"SOA Impl","url":"https://jonas-paprotka.de/ref/codeunit/4587-soa-impl/"},"codeunit:4396":{"name":"SOA Email Setup","url":"https://jonas-paprotka.de/ref/codeunit/4396-soa-email-setup/"},"table:2000000283":{"name":"Agent Annotation","url":"https://jonas-paprotka.de/ref/table/2000000283-agent-annotation/"},"codeunit:8703":{"name":"Feature Telemetry","url":"https://jonas-paprotka.de/ref/codeunit/8703-feature-telemetry/"},"codeunit:4400":{"name":"SOA Setup","url":"https://jonas-paprotka.de/ref/codeunit/4400-soa-setup/"},"codeunit:4321":{"name":"Agent","url":"https://jonas-paprotka.de/ref/codeunit/4321-agent/"},"codeunit:4421":{"name":"SOA Attachment MLLM","url":"https://jonas-paprotka.de/ref/codeunit/4421-soa-attachment-mllm/"},"table:2000000275":{"name":"Agent Task Message Attachment","url":"https://jonas-paprotka.de/ref/table/2000000275-agent-task-message-attachment/"},"codeunit:4590":{"name":"SOA Billing","url":"https://jonas-paprotka.de/ref/codeunit/4590-soa-billing/"},"codeunit:7771":{"name":"Azure OpenAI","url":"https://jonas-paprotka.de/ref/codeunit/7771-azure-openai/"},"codeunit:7768":{"name":"AOAI Deployments","url":"https://jonas-paprotka.de/ref/codeunit/7768-aoai-deployments/"},"codeunit:7763":{"name":"AOAI Chat Messages","url":"https://jonas-paprotka.de/ref/codeunit/7763-aoai-chat-messages/"},"codeunit:7770":{"name":"AOAI Operation Response","url":"https://jonas-paprotka.de/ref/codeunit/7770-aoai-operation-response/"},"codeunit:4302":{"name":"SOA Validation Function","url":"https://jonas-paprotka.de/ref/codeunit/4302-soa-validation-function/"},"codeunit:7761":{"name":"AOAI Chat Completion Params","url":"https://jonas-paprotka.de/ref/codeunit/7761-aoai-chat-completion-params/"},"codeunit:2200":{"name":"Azure Key Vault","url":"https://jonas-paprotka.de/ref/codeunit/2200-azure-key-vault/"}},"procs":[{"name":"GetAgentAnnotations","line":37,"kind":"procedure","access":"internal","params":2,"steps":[[50,"call","ShouldAddOverProcessLimitAnnotation",1],[51,"call","AddOverProcessLimitAnnotation",2],[52,"call","ShouldAddAccessTokenAnnotation",0],[53,"call","AddAccessTokenAnnotation",1],[55,"call","ShouldAddAgentTaskFailureAnnotation",0],[56,"call","AddAgentTaskFailureAnnotation",1],[58,"call","ShouldAddAgentTaskSendRepliesFailureAnnotation",0],[59,"call","AddAgentTaskSendRepliesFailureAnnotation",1]]},{"name":"ShouldAddOverProcessLimitAnnotation","line":62,"kind":"procedure","access":"local","params":1,"steps":[[68,"ext","codeunit",4587,"GetProcessLimitPerDay",1],[69,"ext","codeunit",4396,"GetEmailCountProcessedWithin24hrs",0]]},{"name":"AddOverProcessLimitAnnotation","line":73,"kind":"procedure","access":"local","params":2,"steps":[[83,"write",2000000283,"Insert"],[84,"ext","codeunit",8703,"LogUsage",4],[84,"ext","codeunit",4400,"GetFeatureName",0],[86,"ext","codeunit",8703,"LogError",6],[86,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"ShouldAddAccessTokenAnnotation","line":89,"kind":"procedure","access":"local","params":0,"steps":[[103,"call","GetFailedTaskLimit",0],[106,"call","GetFailedTaskLimit",0]]},{"name":"AddAccessTokenAnnotation","line":109,"kind":"procedure","access":"local","params":1,"steps":[[115,"write",2000000283,"Insert"]]},{"name":"ShouldAddAgentTaskFailureAnnotation","line":118,"kind":"procedure","access":"local","params":0,"steps":[[132,"call","GetFailedTaskLimit",0],[135,"call","GetFailedTaskLimit",0]]},{"name":"AddAgentTaskFailureAnnotation","line":138,"kind":"procedure","access":"local","params":1,"steps":[[146,"write",2000000283,"Insert"],[147,"ext","codeunit",8703,"LogUsage",4],[147,"ext","codeunit",4400,"GetFeatureName",0],[149,"ext","codeunit",8703,"LogError",6],[149,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"ShouldAddAgentTaskSendRepliesFailureAnnotation","line":152,"kind":"procedure","access":"local","params":0,"steps":[[166,"call","GetFailedTaskLimit",0],[169,"call","GetFailedTaskLimit",0]]},{"name":"AddAgentTaskSendRepliesFailureAnnotation","line":172,"kind":"procedure","access":"local","params":1,"steps":[[180,"write",2000000283,"Insert"],[181,"ext","codeunit",8703,"LogUsage",4],[181,"ext","codeunit",4400,"GetFeatureName",0],[183,"ext","codeunit",8703,"LogError",6],[183,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"GetAgentTaskMessageAnnotations","line":191,"kind":"procedure","access":"internal","params":2,"steps":[[197,"call","CheckReleavanceOfAgentTaskMessage",2],[205,"ext","codeunit",4321,"GetDisplayName",1],[208,"ext","codeunit",8703,"LogUsage",4],[208,"ext","codeunit",4400,"GetFeatureName",0],[209,"write",2000000283,"Insert"],[210,"ext","codeunit",8703,"LogError",6],[210,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"CheckReleavanceOfAgentTaskMessage","line":213,"kind":"procedure","access":"local","params":2,"steps":[[218,"call","CheckIfMessageRelevant",2],[219,"call","CheckIfAttachmentRelevant",1]]},{"name":"CheckIfAttachmentRelevant","line":228,"kind":"procedure","access":"internal","params":1,"steps":[[248,"call","ProcessAttachmentForRelevance",3]]},{"name":"ProcessAttachmentForRelevance","line":258,"kind":"procedure","access":"local","params":3,"steps":[[271,"ext","codeunit",4421,"EnsureCanonicalTextContent",3],[273,"call","HandleAttachmentExtractionFailed",5],[279,"call","GetMaxAttachmentContentLength",0],[280,"call","IgnoreAttachmentExceedsContentLength",6],[285,"call","CheckIfAttachmentRelevant",4],[288,"write",2000000275,"Modify"],[289,"ext","codeunit",4590,"LogIrrelevantAttachment",4],[294,"call","GetMaxAttachmentContentLength",0],[295,"call","IgnoreAttachmentExceedsContentLength",6],[300,"ext","codeunit",4590,"LogRelevantAttachment",4]]},{"name":"IgnoreAttachmentExceedsContentLength","line":304,"kind":"procedure","access":"local","params":6,"steps":[[308,"write",2000000275,"Modify"],[309,"ext","codeunit",4590,"LogIrrelevantAttachment",4],[316,"ext","codeunit",8703,"LogUsage",4],[316,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"HandleAttachmentExtractionFailed","line":320,"kind":"procedure","access":"local","params":5,"steps":[[324,"write",2000000275,"Modify"],[325,"ext","codeunit",4590,"LogIrrelevantAttachment",4],[330,"ext","codeunit",8703,"LogError",6],[330,"ext","codeunit",4400,"GetFeatureName",0]]},{"name":"CheckIfAttachmentRelevant","line":334,"kind":"procedure","access":"local","params":4,"steps":[[349,"ext","codeunit",7771,"SetAuthorization",2],[349,"ext","codeunit",7768,"GetGPT56CeresLatest",0],[353,"call","GetIrrelevantAttachmentPrompt",1],[354,"ext","codeunit",8703,"LogError",6],[354,"ext","codeunit",4400,"GetFeatureName",0],[358,"ext","codeunit",7771,"SetCopilotCapability",1],[360,"ext","codeunit",7763,"SetPrimarySystemMessage",1],[361,"ext","codeunit",7763,"AddTool",1],[362,"ext","codeunit",7763,"SetToolInvokePreference",1],[364,"call","SetAOAIParameters",2],[370,"ext","codeunit",8703,"LogUsage",4],[370,"ext","codeunit",4400,"GetFeatureName",0],[374,"ext","codeunit",7763,"AddUserMessage",1],[375,"ext","codeunit",7771,"GenerateChatCompletion",3],[376,"ext","codeunit",7770,"IsSuccess",0],[377,"ext","codeunit",8703,"LogError",6],[377,"ext","codeunit",4400,"GetFeatureName",0],[377,"ext","codeunit",7770,"GetStatusCode",0],[377,"ext","codeunit",7770,"GetError",0],[380,"ext","codeunit",7770,"IsFunctionCall",0],[381,"ext","codeunit",8703,"LogError",6],[381,"ext","codeunit",4400,"GetFeatureName",0],[384,"ext","codeunit",4302,"IsIrrelevant",0],[385,"ext","codeunit",8703,"LogUsage",4],[385,"ext","codeunit",4400,"GetFeatureName",0],[389,"ext","codeunit",8703,"LogUsage",4],[389,"ext","codeunit",4400,"GetFeatureName",0],[390,"ext","codeunit",4302,"GetIrrelevantReason",0]]},{"name":"CheckIfMessageRelevant","line":394,"kind":"procedure","access":"local","params":2,"steps":[[409,"ext","codeunit",7771,"SetAuthorization",2],[409,"ext","codeunit",7768,"GetGPT56CeresLatest",0],[412,"call","GetIrrelevantMessagePrompt",1],[413,"ext","codeunit",8703,"LogError",6],[413,"ext","codeunit",4400,"GetFeatureName",0],[417,"ext","codeunit",7771,"SetCopilotCapability",1],[419,"ext","codeunit",7763,"SetPrimarySystemMessage",1],[420,"ext","codeunit",7763,"AddTool",1],[421,"ext","codeunit",7763,"SetToolInvokePreference",1],[423,"call","SetAOAIParameters",2],[435,"ext","codeunit",7763,"AddUserMessage",1],[438,"ext","codeunit",7763,"AddAssistantMessage",1],[441,"ext","codeunit",8703,"LogUsage",4],[441,"ext","codeunit",4400,"GetFeatureName",0],[445,"ext","codeunit",7771,"GenerateChatCompletion",3],[446,"ext","codeunit",7770,"IsSuccess",0],[447,"ext","codeunit",8703,"LogError",6],[447,"ext","codeunit",4400,"GetFeatureName",0],[447,"ext","codeunit",7770,"GetStatusCode",0],[447,"ext","codeunit",7770,"GetError",0],[450,"ext","codeunit",7770,"IsFunctionCall",0],[451,"ext","codeunit",8703,"LogError",6],[451,"ext","codeunit",4400,"GetFeatureName",0],[454,"ext","codeunit",4302,"IsIrrelevant",0],[455,"ext","codeunit",8703,"LogUsage",4],[455,"ext","codeunit",4400,"GetFeatureName",0],[459,"ext","codeunit",4302,"GetIrrelevantReason",0]]},{"name":"SetAOAIParameters","line":463,"kind":"procedure","access":"local","params":2,"steps":[[465,"ext","codeunit",7763,"SetHistoryLength",1],[466,"ext","codeunit",7761,"SetTemperature",1]]},{"name":"GetIrrelevantMessagePrompt","line":469,"kind":"procedure","access":"local","params":1,"steps":[[477,"ext","codeunit",2200,"GetAzureKeyVaultSecret",2]]},{"name":"GetIrrelevantAttachmentPrompt","line":484,"kind":"procedure","access":"local","params":1,"steps":[[492,"ext","codeunit",2200,"GetAzureKeyVaultSecret",2]]}]}