Work with a session in Project Perception

  • Applies to: Project Perception

The session detail page shows a full record of agent work, including chat and task history, an overview summarizing what happened in the session, a list of input values provided, and a list of output files produced. Use this page to follow session progress, review results, and continue interacting with agents. For information about browsing and filtering sessions, see View and manage sessions.

Open a session

To open a session detail page:

  1. Go to Perception > Sessions.
  2. Select a session.

Session detail page layout

The session detail page has the following areas:

  • Chat (left): The session chat provides an activity feed with updates on agent progress and a place for users to chat with Perception about this session.
  • Detail panel (center): Opens when you select the session overview, an agent task, or an output to view. This can be expanded or minimized.
  • Contents (right): Shows session progress based on the list of agent tasks and their statuses, inputs provided, and outputs for the session.

At the top of the page contains the Session Title, Session Status, Last Activity Timestamp (the time of the last message entered in this session), Session details, which contains the session ID and information about when and how the session started, the Shared Session icon, which explains that shared sessions can be viewed and interacted with by other users in your orgazniation and shows you the list of current sessions participants (users who either started the session, responded to a waiting for input request, or used the chat within this session), and the Stop Session button, which allows you to manually cancel a session and force it to stop running.

Contents sidebar

Note

The contents sidebar is available in all sessions and organizes the session's key elements in sections.

Overview

Select Overivew to open it in the center panel. The Overview includes a summary of the session progress up until that point. No overview will be available yet when a session first begins. This will become available only once some agents have begun working.

The summary is AI-generated and will update as agents complete more work. Select Download to save the summary.

Tasks

Shows the tasks worked on by agents in the session. Each task is clickable to see result posted by the agent and has a status. Task status reflects what actually ran. If an agent encountered an error or has not begun working yet, that is reflected here.

Inputs

Shows the inputs provided when the session was started, such as a link to a threat intelligence article. Click on an input to open it.

Outputs

Lists the output files produced during the session, for example Markdown reports generated by individual agents. Select a file name to view its contents, or select Download to save it locally.

Note

The number and type of outputs vary by session and playbook. A session where some agents encounter errors may still produce outputs from agents that completed. If no agents produced output, this section shows 0.

Stop a session

If you have permission to interact with a session, you can stop a session at any time.

To stop a session:

  1. Open the session detail page.
  2. Select Stop.
  3. Review the warning message. Stopping a session:
    • Terminates all ongoing agent work immediately
    • Changes the session status to Stopped
    • Marks all unfinished agent activities as Stopped
    • Prevents the session from being resumed
  4. Select Stop session to confirm.

Warning

Stopping a session cannot be undone. Use this action only when the session is no longer needed or is headed in the wrong direction.

Respond to agent requests

When an agent pauses and requires your input or approval, the session status changes to Waiting for input. The agent's request appears in the conversation panel. Respond directly in the conversation to allow the agent to continue.

For more information, see Approve, reject, or stop agentic work.

Understand session and task statuses

For a description of all task status values, see Key concepts in Project Perception.

The session's overall status reflects the combined state of all tasks within it:

  • If a user selects Stop, the session status and any unfinished tasks change to Stopped.
  • If any task is Waiting for Input, the session ststus is Waiting for Input.
  • If nothing is Waiting for Input and any task is In progress, the session status is In progress.
  • If all tasks are Completed, the session status is Completed.
  • If no tasks are Waiting for Input or In Progress and at least one task Failed, then the session is Ended with Failures.

Next steps

  • Last updated on