Page 4312 Agent Task Log Entry

System Application, System.Agents.Troubleshooting

src/System Application/App/Agent/Troubleshooting/AgentTaskLogEntry.Page.al465 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.Troubleshooting;using System.Agents;using System.Security.AccessControl;page 4312 "Agent Task Log Entry"{    PageType = Card;    ApplicationArea = All;    SourceTable = "Agent Task Log Entry";    Caption = 'Agent Task Log Entry (Preview)';    DataCaptionExpression = StrSubstNo(PageCaptionLbl, rec.ID, Rec.Description);    InsertAllowed = false;    ModifyAllowed = false;    DeleteAllowed = false;    AboutTitle = 'About agent task log entry';    AboutText = 'Use this detailed log of what the AI agent found on the page and how it acted autonomously to troubleshoot agent issues. AI-generated content may be incorrect.';    InherentEntitlements = X;    InherentPermissions = X;    layout    {        area(Content)        {            group(General)            {                Caption = 'What the agent decided';                AboutTitle = 'General information';                AboutText = 'General information about the log entry. Click show more to see advanced details about the execution.';                Editable = false;                Visible = IsAgentAction;                field(Description; Rec.Description)                {                    Caption = 'Description';                    ToolTip = 'Specifies the description of the log entry.';                    Importance = Promoted;                    trigger OnDrillDown()                    begin                        if (Rec.Description <> '') then                            Message(Rec.Description);                    end;                }                field(Reason; Rec.Reason)                {                    Caption = 'Reason';                    ToolTip = 'Specifies the reason, provided by the agent, for the log entry.';                    Importance = Promoted;                    trigger OnDrillDown()                    begin                        if (Rec.Reason <> '') then                            Message(Rec.Reason);                    end;                }                field(Details; LogEntryDetailsTxt)                {                    Caption = 'Details';                    ToolTip = 'Specifies the details of the log entry.';                    Importance = Promoted;                    trigger OnDrillDown()                    begin                        if (LogEntryDetailsTxt <> '') then                            Message(LogEntryDetailsTxt);                    end;                }                field(Type; Rec.Type)                {                    Caption = 'Type';                    ToolTip = 'Specifies the type of the log entry.';                    Importance = Additional;                }                field(SystemCreatedAt; Rec.SystemCreatedAt)                {                    Caption = 'Timestamp';                    ToolTip = 'Specifies the date and time when the log entry was created.';                    Importance = Additional;                }                field(UserFullName; Rec."User Full Name")                {                    Caption = 'User full name';                    Tooltip = 'Specifies the full name of the user that was involved';                    Importance = Additional;                }                field(TaskID; Rec."Task ID")                {                    Caption = 'Task ID';                    ToolTip = 'Specifies the ID of the task that was executed.';                    Importance = Additional;                }                field(AgentName; AgentName)                {                    Caption = 'Agent name';                    ToolTip = 'Specifies the name of the agent that performed the tasks.';                    Importance = Additional;                }                field(IsDecision; IsDecisionTxt)                {                    Caption = 'Decision Point';                    ToolTip = 'Specifies if the agent made a decision at this point, or whether this was executed as part of a previous decision.';                    Importance = Additional;                }                field(IsSuccess; IsSuccess)                {                    Caption = 'Success';                    ToolTip = 'Specifies if the operation was successful.';                    Importance = Additional;                }            }            group(GeneralOther)            {                Caption = 'What happened';                AboutTitle = 'General information';                AboutText = 'General information about the log entry. Click show more to see advanced details about the execution.';                Editable = false;                Visible = not IsAgentAction;                field(DescriptionOther; Rec.Description)                {                    Caption = 'Description';                    Importance = Promoted;                }                field(DetailsOther; LogEntryDetailsTxt)                {                    Caption = 'Details';                    ToolTip = 'Specifies the details of the log entry.';                    Importance = Promoted;                    trigger OnDrillDown()                    begin                        Message(LogEntryDetailsTxt);                    end;                }                field(TypeOther; Rec.Type)                {                    Caption = 'Type';                    Importance = Additional;                }                field(TimestampOther; Rec.SystemCreatedAt)                {                    Caption = 'Timestamp';                    ToolTip = 'Specifies the date and time when the log entry was created.';                    Importance = Additional;                }                field(NameOther; Rec."User Full Name")                {                    Caption = 'User full name';                    Tooltip = 'Specifies the full name of the user that took the decision.';                    Importance = Promoted;                }            }            part(InputMessagePart; "Agent Task Message ListPart")            {                Caption = 'What the agent received';                SubPageLink = "Task ID" = field("Task ID");                AboutTitle = 'What the agent received';                AboutText = 'Shows the message the agent received as part of this task.';                Enabled = false;                Visible = Rec.Type = Rec.Type::"Input Message";            }            part(OutputMessagePart; "Agent Task Message ListPart")            {                Caption = 'What the agent wrote';                SubPageLink = "Task ID" = field("Task ID");                AboutTitle = 'What the agent wrote';                AboutText = 'Shows the message the agent wrote as part of this task.';                Enabled = false;                Visible = (Rec.Type = Rec.Type::"Output Message Draft") or (Rec.Type = Rec.Type::"Output Message");            }            part(LogsPart; "Agent Task Log Entry ListPart")            {                Caption = 'What other actions were decided at the same time';                Visible = IsLogPageVisible;                SubPageLink = "Task ID" = field("Task ID");                AboutTitle = 'What other actions were decided at the same time';                AboutText = 'The agent can take multiple actions from the same decision. This lists the log entries related to the actions taken by the agent for this particular entry.';            }            group(PageContentGroup)            {                Caption = 'What the agent saw';                Visible = IsSerializedPageVisible;                AboutTitle = 'What the agent saw';                AboutText = 'The view of the page the agent saw before taking a decision. The data format is subject to change, therefore do not reference it too specifically in instructions.';                field(PageContent; SerializedPageJson)                {                    Caption = 'Page content';                    ExtendedDatatype = RichContent;                    MultiLine = true;                    ShowCaption = false;                    Editable = false;                    trigger OnDrillDown()                    begin                        Message(SerializedPageJson);                    end;                }            }            part("Agent Available Tools"; "Agent Available Tools Part")            {                Caption = 'What tools the agent had access to';                Enabled = false;                AboutTitle = 'What tools the agent had available for the current page and context';                AboutText = 'Lists the tools that were available to the agent at this point. The set of available tools may change over time; do not rely on this list being exhaustive or permanent in instructions.';                Visible = IsAvailableToolsVisible and IsAgentAction;            }            part("Agent Memorized Data"; "Agent Memorized Data Part")            {                Caption = 'What data the agent memorized';                AboutTitle = 'What data the agent memorized';                AboutText = 'Lists the key-value data that the agent had memorized as part of the current task at this point.';                Visible = IsMemorizedDataVisible and IsAgentAction;            }            part(EarlierMessagesPart; "Agent Task Message ListPart")            {                Caption = 'What messages the agent had access to';                SubPageLink = "Task ID" = field("Task ID");                AboutTitle = 'What messages the agent had access to';                AboutText = 'Lists the messages related to the task the agent had access to before taking a decision.';                Enabled = false;                Visible = IsEarlierMessagesPartVisible;            }        }        area(FactBoxes)        {            part(TaskContext; "Agent Task Context Part")            {                ApplicationArea = All;                Caption = 'Task context';                AboutTitle = 'Context information about the task and agent';                AboutText = 'Shows context information such as the agent name, task ID, and company name.';                SubPageLink = ID = field("Task ID");            }            part(PageStack; "Agent PageStack Part")            {                Caption = 'Page stack';                AboutTitle = 'What pages were open below';                AboutText = 'Shows the pages that were opened at the time of the log entry.';                Visible = IsCurrentPageStackVisible;            }            part(TaskPageSettings; "Agent Task Page Settings Part")            {                Caption = 'Task and page settings';                AboutTitle = 'Task and page settings';                AboutText = 'Shows the settings of the page at the time of the log entry.';                Visible = IsTaskPageSettingsVisible;            }        }    }    trigger OnAfterGetCurrRecord()    begin        UpdateControls();    end;    local procedure UpdateControls()    var        AgentTaskLogEntryRecord: Record "Agent Task Log Entry";        AgentTaskLogEntry: Codeunit "Agent Task Log Entry";        AgentTaskImpl: Codeunit "Agent Task Impl.";        ContentInStream: InStream;    begin        LogEntryDetailsTxt := AgentTaskImpl.GetDetailsForAgentTaskLogEntry(Rec);        SetIsAgentAction();        if not MemoryEntry.Get(Rec."Task ID", Rec."Memory Entry ID") then begin            MemoryEntryDetailsTxt := '';            ClearPartsAndVariables();            exit;        end;        MemoryEntry.CalcFields(Details);        MemoryEntry.Details.CreateInStream(ContentInStream, AgentTaskLogEntry.GetDefaultEncoding());        ContentInStream.Read(MemoryEntryDetailsTxt);        SetAgentName();        ParseDetails();        GetPageContext();        if Rec.Id <> GlobalCurrentID then begin            CurrPage.InputMessagePart.Page.DisplayInputMessageFor(MemoryEntry.ID);            CurrPage.OutputMessagePart.Page.DisplayOutputMessageFor(MemoryEntry.ID);            IsEarlierMessagesPartVisible := CurrPage.EarlierMessagesPart.Page.DisplayMessagesEarlierThan(MemoryEntry.ID);            CurrPage.LogsPart.Page.SetEntryFilter(MemoryEntry.ID);            GlobalCurrentID := Rec.Id;            CurrPage.Update(false);        end;        AgentTaskLogEntryRecord.SetRange("Task ID", Rec."Task ID");        AgentTaskLogEntryRecord.SetRange("Memory Entry ID", MemoryEntry.ID);        IsLogPageVisible := AgentTaskLogEntryRecord.Count() > 1;    end;    local procedure ParseDetails()    var        RootObj: JsonObject;    begin        if not RootObj.ReadFrom(MemoryEntryDetailsTxt) then            exit;        IsSuccess := RootObj.Contains(SuccessLbl)            ? Format(RootObj.GetBoolean(SuccessLbl, true))            : '';    end;    local procedure SetAgentName()    var        Agent: Record Agent;        AgentTaskImpl: Codeunit "Agent Task Impl.";    begin        if not AgentTaskImpl.TryGetAgentRecordFromTaskId(Rec."Task ID", Agent) then begin            AgentName := '';            exit;        end;        AgentName := Agent."Display Name";    end;    local procedure SetIsAgentAction()    var        User: Record User;        Default: Boolean;    begin        Default := false;        case Rec.Type of            // Operations always performed by a user.            Rec.Type::"Input Message",            Rec.Type::Resume,            Rec.Type::"User Intervention":                IsAgentAction := false;            // Operations always performed by the agent.            Rec.Type::"Page Operation",            Rec.Type::"Output Message",            Rec.Type::"Output Message Draft",            Rec.Type::"User Intervention Request":                IsAgentAction := true;            // Operations performed by a user or the agent.            Rec.Type::Stop:                IsAgentAction := User.Get(Rec."User Security ID")                    ? User."License Type" = User."License Type"::Agent                    : Default;            // By default, consider it was a user action.            else                IsAgentAction := Default;        end;    end;    local procedure GetPageContext()    var        TempAvailableToolsRecords: Record "Agent JSON Buffer" temporary;        TempPageStacksRecords: Record "Agent JSON Buffer" temporary;        TempMemorizedDataRecords: Record "Agent JSON Buffer" temporary;        AgentTaskLogEntry: Codeunit "Agent Task Log Entry";        AgentSystemPermissionsImpl: Codeunit "Agent System Permissions Impl.";        Root: JsonObject;        TaskPageContextObj: JsonObject;        RawSerializedPageJson: Text;    begin        ContextTxt := AgentTaskLogEntry.ReadContext(Rec);        if ContextTxt = '' then            // Fallback to memory entry context.            ContextTxt := AgentTaskLogEntry.ReadContext(MemoryEntry);        IsSerializedPageVisible := ContextTxt <> '';        if not Root.ReadFrom(ContextTxt) then begin            ClearPartsAndVariables();            exit;        end;        RawSerializedPageJson := Root.GetText(SerializedPageLbl, true);        if RawSerializedPageJson <> '' then            SerializedPageJson := AgentSystemPermissionsImpl.CurrentUserHasTroubleshootAllAgents()                ? AgentTaskLogEntry.FormatJsonTextForRichContent(RawSerializedPageJson)                : AgentTroubleshooterMissingPermissionTxt        else            IsSerializedPageVisible := false;        IsDecisionTxt := Root.Contains(IsDecisionPointLbl)            ? Format(Root.GetBoolean(IsDecisionPointLbl, true))            : Format(false);        AgentTaskLogEntry.ExtractPageStack(TempPageStacksRecords, Root);        IsCurrentPageStackVisible := TempPageStacksRecords.Count() > 0;        CurrPage.PageStack.Page.SetData(TempPageStacksRecords);        CurrPage.PageStack.Page.Update();        AgentTaskLogEntry.ExtractAvailableTools(TempAvailableToolsRecords, Root);        IsAvailableToolsVisible := TempAvailableToolsRecords.Count() > 0;        CurrPage."Agent Available Tools".Page.SetData(TempAvailableToolsRecords);        CurrPage."Agent Available Tools".Page.Update();        AgentTaskLogEntry.ExtractMemorizedData(TempMemorizedDataRecords, Root);        IsMemorizedDataVisible := TempMemorizedDataRecords.Count() > 0;        CurrPage."Agent Memorized Data".Page.SetData(TempMemorizedDataRecords);        CurrPage."Agent Memorized Data".Page.Update();        if (not Root.Contains(TaskPageContextLbl)) then            IsTaskPageSettingsVisible := false        else begin            IsTaskPageSettingsVisible := true;            TaskPageContextObj := Root.GetObject(TaskPageContextLbl, true);            CurrPage.TaskPageSettings.Page.SetData(TaskPageContextObj);            CurrPage.TaskPageSettings.Page.Update();        end;    end;    local procedure ClearPartsAndVariables()    begin        IsDecisionTxt := Format(false);        IsLogPageVisible := false;        IsSerializedPageVisible := false;        IsEarlierMessagesPartVisible := false;        CurrPage.PageStack.Page.ClearData();        CurrPage.PageStack.Page.Update();        IsCurrentPageStackVisible := false;        CurrPage."Agent Available Tools".Page.ClearData();        CurrPage."Agent Available Tools".Page.Update();        IsAvailableToolsVisible := false;        CurrPage."Agent Memorized Data".Page.ClearData();        CurrPage."Agent Memorized Data".Page.Update();        IsMemorizedDataVisible := false;        CurrPage.TaskPageSettings.Page.ClearData();        CurrPage.TaskPageSettings.Page.Update();        IsTaskPageSettingsVisible := false;    end;    var        MemoryEntry: Record "Agent Task Memory Entry";        AgentTroubleshooterMissingPermissionTxt: Label 'Only users who are assigned the ''Troubleshoot All Agents'' permission can view page snapshot data.';        ContextTxt: Text;        MemoryEntryDetailsTxt: Text;        LogEntryDetailsTxt: Text;        AgentName: text;        SerializedPageJson: text;        IsDecisionTxt: Text;        IsSuccess: Text;        IsAgentAction: Boolean;        IsAvailableToolsVisible: Boolean;        IsEarlierMessagesPartVisible: Boolean;        IsSerializedPageVisible: Boolean;        IsTaskPageSettingsVisible: Boolean;        IsCurrentPageStackVisible: Boolean;        IsMemorizedDataVisible: Boolean;        IsLogPageVisible: Boolean;        GlobalCurrentID: Integer;        SerializedPageLbl: Label 'serializedPage', Locked = true;        IsDecisionPointLbl: Label 'isDecisionPoint', Locked = true;        TaskPageContextLbl: Label 'taskPageContext', Locked = true;        SuccessLbl: Label 'success', Locked = true;        PageCaptionLbl: Label 'Log %1 - %2', Comment = '%1 is the id, and %2 is the description of it.';}