View and manage sessions

The Sessions page in Perception displays all sessions visible to you based on your access permissions. Use this page to monitor active sessions, review completed work, and start new sessions.

Access the Sessions page

To view the Sessions list:

  1. Sign in to the Microsoft Defender portal.
  2. Select Perception in the navigation pane.
  3. Select Sessions.

Understand session visibility

Sessions in Perception are shared with all users who also have permission to view or run sessions involving all the specific agents in the session.

Switch between list view and Kanban board view

The Sessions page supports the following viewing modes:

  • List view: Displays sessions in a table with detailed columns. Use list view when you need to see comprehensive information or large numbers of sessions.
  • Card view: Displays sessions as cards organized by status. Use card view when you want a Kanban board-like visual overview of session progress.

To toggle between views:

  1. Select List view or Card view at the top of the Sessions page.

Start a new session

You can start a session from multiple entry points in Project Perception. Choose the approach that best fits your current workflow:

Start a session using the New session button

The New session button is available from the Sessions list and other locations in Project Perception.

  1. Select New session.
  2. Choose a playbook from the list.
  3. Provide the required inputs.
  4. Select Start session.

Start from a specific playbook

Open the playbook details by using one of the following paths:

  • Go to Perception > Playbooks, and then select a playbook and run it.
  • Go to Perception > Agents, open an agent, and then select one of its playbooks.

From the playbook details, select New session, provide the required inputs, and select Start session. For the complete procedure, see Start a session from a playbook.

Start from a specific input value

If you're viewing a case, incident, alert, or a threat intelligence article, you can start a session directly from that page without navigating to Perception first. For more information, see Run playbooks from incidents and threat intelligence.

Start from chat

Use chat to describe your task in natural language. Perception identifies the most appropriate playbook, pre-populates the inputs it can infer, and runs the session for you. For more information, see Interact with Project Perception using chat.

The new session appears in the Sessions list with an In progress status.

View session details from the sessions list

Select a session to open its detail page. For a detailed walkthrough of the session detail page, including the session chat, tasks list, and how to respond to agent requests, see Work with a session.

Understand session statuses

Sessions progress through the following statuses:

Status Description What happens next
In progress One or more agents are actively working. The session continues until agents complete their work or request input.
Waiting for input One or more agent tasks are paused and need user input to continue. Review the agent's request and provide approval, rejection, or alternative guidance.
Completed All agent tasks finished successfully. Review the session summary and artifacts.
Ended with Failures All agent tasks have finished running, but one or more failed. Review the session summary and artifacts. A new session may need to be started to complete failed tasks.
Stopped A user manually forced the session to terminate by selecting Stop. Any unfinished agent activities are also marked Stopped. The session can't be resumed and is archived.

Sessions do not automatically restart. To investigate a similar scenario, start a new session.

Note

Session status also controls the availability of agent chat. The dedicated chat for each agent is disabled while the agent is actively running and becomes available when the agent is waiting for input or has completed its current step. For more information, see Work with a session.

Session notifications

Perception uses Defender's in-product notification system to draw attention to:

  1. Sessions waiting for input (notify all users who have run access to the session when the session enters this status)
  2. Sessions completed (notify all session participants, i.e. users who either started the session or previously responded to a request for input or entered a message in the session chat when the session enters this status)

These notifications allow users to continue their work in the Defender portal and return to sessions only when there are relevant updates instead of having to check on individual sessions or the sessions list to check progress. Notifications contain links to open the session and appear in the top right of a user's screen as long as they are anywhere in the Defender portal at the time. If dismissed, past notifications can be accessed by clicking on the notifications icon at the top right, which shows the user's notification history.

Other notification options and/or notifications outside of the product via email, teams, or chat are not currently supported.

Next steps