Codeunit 4325 Agent Setup Impl.

System Application, System.Agents

src/System Application/App/Agent/Setup/SetupPart/AgentSetupImpl.Codeunit.al312 lines, Copyright (c) Microsoft Corporation. MIT

// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace System.Agents;using System.Environment.Configuration;using System.Globalization;codeunit 4325 "Agent Setup Impl."{    InherentEntitlements = X;    InherentPermissions = X;    Access = Internal;    [Scope('OnPrem')]    procedure GetSetupRecord(var AgentSetupBuffer: Record "Agent Setup Buffer"; UserSecurityID: Guid; AgentMetadataProvider: Enum "Agent Metadata Provider"; DefaultUserName: Code[50]; DefaultDisplayName: Text[80]; AgentSummary: Text)    var        TemporaryAgentAccessControl: Record "Agent Access Control" temporary;        Agent: Codeunit Agent;    begin        Clear(AgentSetupBuffer);        AgentSetupBuffer.DeleteAll();        AgentSetupBuffer."User Security ID" := UserSecurityID;        AgentSetupBuffer."Agent Metadata Provider" := AgentMetadataProvider;        UpdateFields(AgentSetupBuffer, UserSecurityID, AgentMetadataProvider, DefaultUserName, DefaultDisplayName);        AgentSetupBuffer.Insert();        SetAgentSummary(AgentSummary, AgentSetupBuffer);        if not IsNullGuid(UserSecurityID) then begin            Agent.GetUserAccess(AgentSetupBuffer."User Security ID", TemporaryAgentAccessControl);            AgentSetupBuffer.SetTempAgentAccessControl(TemporaryAgentAccessControl);        end;    end;    [Scope('OnPrem')]    procedure SaveChanges(var AgentSetupBuffer: Record "Agent Setup Buffer") "Agent User ID": Guid    begin        if IsNullGuid(AgentSetupBuffer."User Security ID") then            exit(CreateAgent(AgentSetupBuffer));        UpdateAgent(AgentSetupBuffer);        exit(AgentSetupBuffer."User Security ID");    end;    [Scope('OnPrem')]    procedure OpenAgentAccessControlSetup(var AgentSetupBuffer: Record "Agent Setup Buffer"): Boolean    var        TempAgentAccessControl: Record "Agent Access Control" temporary;        SelectAgentAccessControl: Page "Select Agent Access Control";    begin        AgentSetupBuffer.GetTempAgentAccessControl(TempAgentAccessControl);        SelectAgentAccessControl.Initialize(AgentSetupBuffer."User Security ID", TempAgentAccessControl);        if (SelectAgentAccessControl.RunModal() in [Action::LookupOK, Action::OK]) then begin            AgentSetupBuffer."Access Updated" := true;            AgentSetupBuffer.Modify(true);            AgentSetupBuffer.SetTempAgentAccessControl(TempAgentAccessControl);            exit(true);        end;        exit(false);    end;    [Scope('OnPrem')]    procedure GetChangesMade(var AgentSetupBuffer: Record "Agent Setup Buffer"): Boolean    begin        exit(AgentSetupBuffer."Access Updated" or AgentSetupBuffer."Values Updated" or AgentSetupBuffer."User Settings Updated" or AgentSetupBuffer."State Updated");    end;    [Scope('OnPrem')]    procedure OpenProfileLookup(var UserSettingsRec: Record "User Settings"): Boolean    var        AgentImpl: Codeunit "Agent Impl.";    begin        exit(AgentImpl.ProfileLookup(UserSettingsRec));    end;    /// <summary>    /// Opens the setup page for the specified agent.    /// </summary>    /// <param name="AgentUserSecurityID">Security ID of the agent.</param>    [Scope('OnPrem')]    procedure OpenSetupPage(AgentUserSecurityID: Guid)    var        Agent: Record Agent;        AgentImpl: Codeunit "Agent Impl.";    begin        AgentImpl.GetAgent(Agent, AgentUserSecurityID);        AgentImpl.OpenSetupPageId(Agent."Agent Metadata Provider", AgentUserSecurityID);    end;    [Scope('OnPrem')]    procedure FindAgentByUserName(AgentUserName: Text; var AgentUserSecurityId: Guid): Boolean    var        AgentRec: Record Agent;    begin        AgentRec.SetRange("User Name", AgentUserName);        if AgentRec.FindFirst() then begin            AgentUserSecurityId := AgentRec."User Security ID";            exit(true);        end;        AgentRec.SetFilter("User Name", '@' + AgentUserName + '*');        if AgentRec.FindFirst() then begin            AgentUserSecurityId := AgentRec."User Security ID";            AgentUserName := AgentRec."User Name";            exit(true);        end;        exit(false);    end;    [Scope('OnPrem')]    procedure OpenAgentLookup(var AgentUserSecurityId: Guid): Boolean    var        Agent: Record Agent;        AgentImpl: Codeunit "Agent Impl.";    begin        AgentImpl.SelectAgent(Agent);        AgentUserSecurityId := Agent."User Security ID";        exit(not IsNullGuid(AgentUserSecurityId));    end;    [Scope('OnPrem')]    procedure OpenAgentLookup(AgentType: Enum "Agent Metadata Provider"; var AgentUserSecurityId: Guid): Boolean    var        Agent: Record Agent;        AgentImpl: Codeunit "Agent Impl.";    begin        Agent.SetRange("Agent Metadata Provider", AgentType);        AgentImpl.SelectAgent(Agent);        AgentUserSecurityId := Agent."User Security ID";        exit(not IsNullGuid(AgentUserSecurityId));    end;    local procedure UpdateFields(var AgentSetupBuffer: Record "Agent Setup Buffer"; UserSecurityID: Guid; AgentMetadataProvider: Enum "Agent Metadata Provider"; DefaultUserName: Code[50]; DefaultDisplayName: Text[80])    var        Agent: Record Agent;        TempUserSettings: Record "User Settings";        Language: Codeunit Language;        AgentMetadata: Interface IAgentMetadata;    begin        AgentSetupBuffer.GetUserSettings(TempUserSettings);        AgentSetupBuffer."Language Used" := CopyStr(Language.GetWindowsLanguageName(TempUserSettings."Language ID"), 1, MaxStrLen(AgentSetupBuffer."Language Used"));        if not IsNullGuid(UserSecurityID) then            if Agent.Get(UserSecurityID) then begin                AgentSetupBuffer."User Name" := Agent."User Name";                AgentSetupBuffer."Display Name" := Agent."Display Name";                AgentSetupBuffer.State := Agent.State;                AgentMetadata := Agent."Agent Metadata Provider";                AgentSetupBuffer.Initials := AgentMetadata.GetInitials(UserSecurityID);                AgentSetupBuffer."Configured By" := Agent.SystemModifiedBy;                exit;            end;        AgentMetadata := AgentMetadataProvider;        AgentSetupBuffer."User Name" := DefaultUserName;        AgentSetupBuffer."Display Name" := DefaultDisplayName;        AgentSetupBuffer.Initials := AgentMetadata.GetInitials(UserSecurityID);        AgentSetupBuffer.State := AgentSetupBuffer.State::Disabled;    end;    [Scope('OnPrem')]    procedure OpenLanguageAndRegionPage(var AgentSetupBuffer: Record "Agent Setup Buffer"): Boolean    var        TempUserSettings: Record "User Settings";        Language: Codeunit Language;        AgentUserSettings: Page "Agent User Settings";    begin        AgentSetupBuffer.GetUserSettings(TempUserSettings);        AgentUserSettings.InitializeTemp(TempUserSettings);        if AgentUserSettings.RunModal() in [Action::LookupOK, Action::OK] then begin            AgentUserSettings.GetValues(TempUserSettings);            AgentSetupBuffer."User Settings Updated" := true;#pragma warning disable AA0139            AgentSetupBuffer."Language Used" := Language.GetWindowsLanguageName(TempUserSettings."Language ID");#pragma warning restore AA0139            AgentSetupBuffer.SetUserSettings(TempUserSettings);            AgentSetupBuffer.Modify();            exit(true);        end;        exit(false);    end;    [Scope('OnPrem')]    procedure GetAgentSummary(var AgentSetupBuffer: Record "Agent Setup Buffer"): Text    var        SummaryInStream: InStream;        SummaryText: Text;        FullSummaryText: TextBuilder;    begin        AgentSetupBuffer.CalcFields("Agent Summary");        if not AgentSetupBuffer."Agent Summary".HasValue() then            exit('');        AgentSetupBuffer."Agent Summary".CreateInStream(SummaryInStream, GetDefaultEncoding());        repeat            SummaryInStream.ReadText(SummaryText);            FullSummaryText.Append(SummaryText);        until SummaryInStream.EOS();        exit(FullSummaryText.ToText());    end;    internal procedure AppendAgentSummary(var AgentSetupBuffer: Record "Agent Setup Buffer"; SummaryText: Text): Text    var        TempUserSettings: Record "User Settings";        Language: Codeunit Language;        NewSummaryText: Text;    begin        NewSummaryText := SummaryText;        if not NewSummaryText.Contains(ReviewForAccuracyAgentUsesAILbl) then            NewSummaryText := StrSubstNo(AppendTextToEndTxt, NewSummaryText, ReviewForAccuracyAgentUsesAILbl);        if not SummaryText.Contains(LanguageUsedLbl) then begin            AgentSetupBuffer.GetUserSettings(TempUserSettings);            NewSummaryText := StrSubstNo(AppendTextToEndTxt, NewSummaryText, StrSubstNo(LanguageUsedLbl, Language.GetWindowsLanguageName(TempUserSettings."Language ID")));        end;        exit(NewSummaryText);    end;    internal procedure CopySetupRecord(var Target: Record "Agent Setup Buffer"; var Source: Record "Agent Setup Buffer")    var        TempUserSettings: Record "User Settings" temporary;        TempAccessControl: Record "Agent Access Control" temporary;    begin        Target.Copy(Source, true);        Source.GetUserSettings(TempUserSettings);        Target.SetUserSettings(TempUserSettings);        Source.GetTempAgentAccessControl(TempAccessControl);        Target.SetTempAgentAccessControl(TempAccessControl);    end;    local procedure CreateAgent(var AgentSetupBuffer: Record "Agent Setup Buffer"): Guid    var        AgentRecord: Record Agent;        TempNewUserSettings: Record "User Settings";        TemporaryAgentAccessControl: Record "Agent Access Control" temporary;        Agent: Codeunit Agent;    begin        AgentSetupBuffer.GetTempAgentAccessControl(TemporaryAgentAccessControl);        AgentSetupBuffer."User Security ID" := Agent.Create(AgentSetupBuffer."Agent Metadata Provider", AgentSetupBuffer."User Name", AgentSetupBuffer."Display Name", TemporaryAgentAccessControl);        AgentRecord.Get(AgentSetupBuffer."User Security ID");        AgentSetupBuffer.GetUserSettings(TempNewUserSettings);        Agent.UpdateLocalizationSettings(AgentRecord."User Security ID", TempNewUserSettings);        UpdateAgentState(AgentSetupBuffer);        exit(AgentRecord."User Security ID");    end;    local procedure UpdateAgent(var AgentSetupBuffer: Record "Agent Setup Buffer")    var        AgentRecord: Record Agent;        TempNewUserSettings: Record "User Settings";        TemporaryAgentAccessControl: Record "Agent Access Control" temporary;        Agent: Codeunit Agent;    begin        AgentRecord.Get(AgentSetupBuffer."User Security ID");        if AgentSetupBuffer."Values Updated" then            Agent.SetDisplayName(AgentSetupBuffer."User Security ID", AgentSetupBuffer."Display Name");        if AgentSetupBuffer."User Settings Updated" then begin            AgentSetupBuffer.GetUserSettings(TempNewUserSettings);            Agent.UpdateLocalizationSettings(AgentSetupBuffer."User Security ID", TempNewUserSettings);        end;        if AgentSetupBuffer."Access Updated" then begin            AgentSetupBuffer.GetTempAgentAccessControl(TemporaryAgentAccessControl);            Agent.UpdateAccess(AgentSetupBuffer."User Security ID", TemporaryAgentAccessControl);        end;        if AgentSetupBuffer."State Updated" then            UpdateAgentState(AgentSetupBuffer);    end;    local procedure UpdateAgentState(var AgentSetupBuffer: Record "Agent Setup Buffer")    var        Agent: Codeunit Agent;    begin        if AgentSetupBuffer.State = AgentSetupBuffer.State::Enabled then            Agent.Activate(AgentSetupBuffer."User Security ID")        else            Agent.Deactivate(AgentSetupBuffer."User Security ID");    end;    local procedure SetAgentSummary(SummaryText: Text; var AgentSetupBuffer: Record "Agent Setup Buffer")    var        SummaryOutStream: OutStream;    begin        Clear(AgentSetupBuffer."Agent Summary");        AgentSetupBuffer."Agent Summary".CreateOutStream(SummaryOutStream, GetDefaultEncoding());        SummaryOutStream.WriteText(SummaryText);        AgentSetupBuffer.Modify();    end;    local procedure GetDefaultEncoding(): TextEncoding    begin        exit(TextEncoding::UTF8);    end;    var        LanguageUsedLbl: Label 'Language used: %1', Comment = '%1 is the language name, e.g. English (United States).';        ReviewForAccuracyAgentUsesAILbl: Label 'This agent uses AI - review its actions for accuracy.';        AppendTextToEndTxt: Label '%1\\%2', Comment = '%1 is the existing summary text, %2 is the text that we are appending to the end';}