Some products and features are in the process of being renamed. Generative playbook and flow features are also being migrated to a single consolidated console. See the details.
Stay organized with collections
Save and categorize content based on your preferences.
A session represents a conversation
between a Conversational Agents (Dialogflow CX) agent and an end-user.
You can create special entities, called session entities,
or user entities,
during a session.
Session entities can extend or replace custom entity types
and only exist during the session that they were created for.
All session data, including session entities,
is stored by Conversational Agents (Dialogflow CX) for 30 minutes.
For example, if your agent has a @fruit entity type
that includes "pear" and "grape",
that entity type could be updated to include "apple" or "orange",
depending on the information your agent collects from the end-user.
The updated entity type would have the "apple" or "orange" entity entry
for the rest of the session.
Managing session entities with the API
To manage session entities with the API,
use the methods for the SessionEntity type.
Select a protocol and version for the SessionEntityType reference:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eA session in Conversational Agents (Dialogflow CX) represents a conversation between the agent and an end-user.\u003c/p\u003e\n"],["\u003cp\u003eSession entities, also known as user entities, are special entities created during a session that can expand or replace custom entity types.\u003c/p\u003e\n"],["\u003cp\u003eSession entities are only active for the duration of the session in which they are created.\u003c/p\u003e\n"],["\u003cp\u003eAll session data, including session entities, is temporarily stored by Conversational Agents (Dialogflow CX) for a duration of 30 minutes.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eSessionEntityType\u003c/code\u003e API can be used to manage session entities, with resources and interfaces available for various protocols and versions, including REST and RPC.\u003c/p\u003e\n"]]],[],null,["# Session entities\n\nA *session* represents a conversation\nbetween a Conversational Agents (Dialogflow CX) agent and an end-user.\nYou can create special entities, called *session entities* ,\nor *user entities*,\nduring a session.\nSession entities can extend or replace custom entity types\nand only exist during the session that they were created for.\nAll session data, including session entities,\nis stored by Conversational Agents (Dialogflow CX) for 30 minutes.\n\nFor example, if your agent has a `@fruit` entity type\nthat includes \"pear\" and \"grape\",\nthat entity type could be updated to include \"apple\" or \"orange\",\ndepending on the information your agent collects from the end-user.\nThe updated entity type would have the \"apple\" or \"orange\" entity entry\nfor the rest of the session.\n\nManaging session entities with the API\n--------------------------------------\n\nTo manage session entities with the API,\nuse the methods for the `SessionEntity` type.\n\n\nGo to the SessionEntityType API reference \n**Select a protocol and version for the SessionEntityType reference:**\n\nClose\n\n\u003cbr /\u003e"]]