Agentic Session

An Agentic Session object represents a conversation with the Google Threat Intelligence agent. Each session keeps the ordered list of events exchanged with the agent and any artifacts attached to it. The object type is agentic_session. Sessions are retrieved with Get a session and enumerated with List sessions.

Object Attributes

An agentic session object contains the following attributes:

title: <string> title of the session.
creation_date: <string> ISO-8601 UTC timestamp of when the session was created.
last_modification_date: <string> ISO-8601 UTC timestamp of the session's last modification.
events: <list of dictionaries> ordered list of events exchanged with the agent. Each event is a DisplayableUiMessage with:
- id: <string> unique identifier of the event.
- message_type: <string> type of the event. One of USER_MESSAGE, AGENT_THOUGHT, AGENT_FINAL_RESPONSE, FUNCTION_CALL, FUNCTION_RESPONSE.
- Depending on message_type, the event carries its corresponding payload:
  - user_message: <dictionary> payload for USER_MESSAGE. The message submitted by the user.
  - agent_thought: <dictionary> payload for AGENT_THOUGHT. An intermediate reasoning step produced by the agent.
  - agent_final_response: <dictionary> payload for AGENT_FINAL_RESPONSE. The agent's final answer.
  - function_call: <dictionary> payload for FUNCTION_CALL. A tool invocation requested by the agent.
  - function_response: <dictionary> payload for FUNCTION_RESPONSE. The result returned by a called function.