Alguns produtos e recursos estão sendo renomeados. Os recursos de playbook generativo e de fluxo também estão sendo migrados para um único console consolidado. Confira os detalhes.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Uma conversa (sessão) de agentes de conversação (Dialogflow CX) pode ser descrita e visualizada como uma
máquina de estado.
Os estados de uma sessão são representados por
páginas.
Para cada fluxo, você define muitas páginas. As páginas combinadas podem processar uma conversa completa sobre os tópicos para os quais o fluxo foi projetado.
A qualquer momento, exatamente uma página é a página atual, a página atual é considerada ativa e o fluxo associado a essa página é considerado ativo.
Todos os fluxos têm uma página inicial especial.
Quando um fluxo se torna ativo inicialmente,
a página inicial se torna a página atual.
Para cada turno de conversa,
a página atual permanecerá a mesma ou fará a transição para outra.
Cada página é configurada para coletar informações
do usuário final relevantes
para o estado de conversa representado pela página.
Por exemplo, é possível criar as páginas (em azul) no diagrama abaixo para um fluxo de Pedido de comida de um agente que entrega pizzas.
O nó Start do diagrama
representa a página inicial do fluxo Food Order.
Quando o fluxo for concluído, ele faz a transição para o fluxo de Confirmação.
Ciclo de vida de uma página
Quando uma página fica ativa,
o agente segue várias etapas que podem envolver
fulfillment de entrada, preenchimento de formulários, avaliação de manipulador de estado,
solicitação de parâmetro de formulário, envio de mensagens de resposta ao usuário final
e uma mudança de página ou um loop de repetição:
Os detalhes desse processo são os seguintes:
Se a entrada fulfillment existir para a página, ela será chamada.
Todas as respostas estáticas fornecidas pelo fulfillment são adicionadas à
fila de resposta.
Se a resposta parcial
estiver ativada, os agentes de conversação (Dialogflow CX) vão limpar a fila de respostas e enviar todas as mensagens
em fila como uma resposta parcial ao autor da chamada da API de streaming.
Se o fulfillment tiver um webhook, ele será chamado, e as respostas
adicionais poderão ser incluídas na fila. Essas outras respostas não acionam a limpeza imediata da fila de respostas.
Se a página tiver parâmetros de formulário, eles poderão ser preenchidos automaticamente:
Se uma
rota
acionou uma transição a essa página
e a rota contém uma
intent
correspondente, qualquer parâmetro de intent com o mesmo nome de um
parâmetro de formulário
será copiado para o parâmetro do formulário.
Se algum gerenciador de estado estiver
no escopo,
eles será avaliado de acordo com as
regras de ordem de avaliação do gerenciador.
Isso pode envolver rotas, manipuladores de eventos
ou gerenciadores de nova invocação da iteração de loop anterior.
Se algum gerenciador de estado for chamado,
um ou ambos os itens a seguir poderão acontecer:
Se o fulfillment existir para o gerenciador, ele será chamado.
Todas as respostas estáticas fornecidas pelo fulfillment são adicionadas à
fila de resposta. A resposta parcial e o webhook também serão executados se estiverem ativados.
Se houver um fluxo ou uma página de destino para o gerenciador,
a sessão transitará para o destino e a página ficará inativa.
Se todos os itens a seguir forem verdadeiros, um prompt de parâmetro de formulário será adicionado à fila de resposta:
A página tem um formulário.
Ainda há parâmetros de formulário obrigatórios para preencher.
A resposta parcial e o webhook serão executados se estiverem ativados.
As mensagens restantes da fila de resposta são enviadas ao usuário final,
e o agente aguarda a entrada do usuário final.
Se a entrada do usuário final fornecer um parâmetro de formulário solicitado, preencha o parâmetro.
Passe para a etapa 3.
Navegação do ciclo de vida da página
Com o visualizador de etapas de execução do simulador, você alterna entre as etapas de uma conversa específica e coloca os elementos do construtor relacionados ao agente em foco para cada etapa. No
exemplo a seguir, a entrada do usuário final "Quero alugar um carro" aciona cinco
etapas de execução e transição:
O visualizador de etapas de execução leva você à página inicial de conversa
para a primeira etapa. Neste caso, é a página inicial padrão.
A rota de transição da intent car_rental.reservation_create é acionada.
O visualizador de etapas de execução leva essa rota para o foco, onde é possível ver
que o destino da transição é a página Pickup Location.
O agente entra na página Pickup Location.
O agente avalia o fulfillment da entrada da página Pickup Location. O
fulfillment está vazio, então nada acontece.
O agente tenta coletar o parâmetro de formulário necessário pickup_location, e
a mensagem de fulfillment inicial para esse parâmetro é mostrada para o
usuário final.
Também é possível desfazer a última expressão e tentar algo diferente para testar
diferentes transições de páginas.
Nome de exibição:
um nome legível para sua página.
Fulfillment de entrada (também conhecida como Caixa de diálogo de entrada):
é o
fulfillment
a ser chamado quando a página se tornar ativa inicialmente.
Parâmetros: são os valores de parâmetro em um formulário de página que capturam a entrada estruturada do usuário final.
Grupos de rotas:
as rotas dentro desses grupos
podem ser chamadas quando a página está ativa.
Para mais detalhes, consulte
Grupos de rotas
Gerenciadores de eventos:
esses gerenciadores de eventos podem ser chamados quando a página está ativa.
Para ver detalhes, consulte Gerenciadores de eventos no nível da página
Configurações da página
As seguintes configurações estão disponíveis para as páginas:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[[["\u003cp\u003eDialogflow CX conversations are structured as state machines, where each state is represented by a page.\u003c/p\u003e\n"],["\u003cp\u003eEach flow in Dialogflow CX can contain multiple pages, and at any given moment, only one page is the active or current page within its flow.\u003c/p\u003e\n"],["\u003cp\u003eThe lifecycle of a page involves entry fulfillment, form pre-filling, state handler evaluation, parameter prompting, sending responses, and potential transitions to other pages.\u003c/p\u003e\n"],["\u003cp\u003ePages collect information from end-users relevant to the current conversational state, using form parameters to capture structured input.\u003c/p\u003e\n"],["\u003cp\u003ePage data includes a display name, entry fulfillment, parameters, routes, route groups, and event handlers, and settings can be accessed and modified through the console or API, allowing for detailed customization.\u003c/p\u003e\n"]]],[],null,["# Pages\n\nA Conversational Agents (Dialogflow CX) conversation (session) can be described and visualized as a\n[state machine](https://en.wikipedia.org/wiki/Finite-state_machine).\nThe states of a session are represented by\n\n*pages*.\n\n\nFor each\n[flow](/dialogflow/cx/docs/concept/flow),\nyou define many pages,\nwhere your combined pages can handle a complete conversation\non the topics the flow is designed for.\nAt any given moment,\nexactly one page is the *current page* ,\nthe current page is considered *active* ,\nand the flow associated with that page is considered *active* .\nEvery flow has a special\n[start page](/dialogflow/cx/docs/concept/flow#start-page).\nWhen a flow initially becomes active,\nthe start page becomes the current page.\nFor each conversational turn,\nthe current page will either stay the same or transition to another page.\n\nYou configure each page to collect information\nfrom the end-user that is relevant\nfor the conversational state represented by the page.\nFor example, you might create the pages (in blue) in the diagram below\nfor a *Food Order* flow of a pizza delivery agent.\nThe *Start* node of the diagram\nrepresents the start page of the *Food Order* flow.\nWhen the flow is complete, it transitions to the *Confirmation* flow.\n\nLifecycle of a page\n-------------------\n\nOnce a page becomes active,\nthe agent follows several steps which may involve\nentry fulfillment, prefilling forms, state handler evaluation,\nform parameter prompting, sending response messages to the end-user,\nand either a page change or a repeat loop:\n\nThe details of this process are as follows:\n\n1. If entry\n [fulfillment](/dialogflow/cx/docs/concept/fulfillment)\n exists for the page, it is called.\n Any static responses provided by fulfillment are added to the\n [response queue](/dialogflow/cx/docs/concept/fulfillment#queue).\n\n If [partial response](/dialogflow/cx/docs/concept/fulfillment#partial-response)\n is enabled, Conversational Agents (Dialogflow CX) flushes the *response queue* and sends all queued\n messages as a partial response to the streaming API caller.\n\n If the fulfillment has a webhook, the webhook is called, which may append\n additional responses to the queue. These additional responses do not\n trigger an immediate flush of the *response queue*.\n2. If the page has form parameters, they may be pre-filled:\n\n - Any set [session parameter](/dialogflow/cx/docs/concept/parameter#session) with the same name as a [form parameter](/dialogflow/cx/docs/concept/parameter#form) is copied to the form parameter.\n - If a [route](/dialogflow/cx/docs/concept/handler#route) triggered a transition to this page, and the route contains a matched [intent](/dialogflow/cx/docs/concept/intent), any intent parameter with the same name as a [form parameter](/dialogflow/cx/docs/concept/parameter#form) is copied to the form parameter.\n3. If any state handlers are\n [in scope](/dialogflow/cx/docs/concept/handler#scope),\n they are evaluated according to the\n [handler evaluation order rules](/dialogflow/cx/docs/concept/handler#eval).\n This can involve routes, event handlers,\n or reprompt handlers invoked from the prior loop iteration.\n If any state handler is called,\n one or both of the following may happen:\n\n - If fulfillment exists for the handler, it is called. Any static responses provided by fulfillment are added to the [response queue](/dialogflow/cx/docs/concept/fulfillment#queue). Partial response and webhook are also executed if they are enabled.\n - If a target flow or page exists for the handler, the session transitions to the target and the page becomes inactive.\n4. If all of the following are true,\n a form parameter prompt is added to the response queue:\n\n - The page has a form.\n - There are required form parameters left to fill.\n - A [reprompt handler](/dialogflow/cx/docs/concept/parameter#reprompt) was not followed in step 3.\n - Partial response and webhook are executed if they are enabled.\n5. The remaining response queue messages are sent to the end-user,\n and the agent waits for end-user input.\n\n6. If end-user input provides a prompted form parameter,\n fill the parameter.\n Continue to step 3.\n\nPage lifecycle navigation\n-------------------------\n\nThe [simulator](/dialogflow/cx/docs/concept/console#simulator) execution steps\nviewer allows you to switch between the steps for a specific conversation turn\nand brings the related agent builder elements into focus for each step. In the\nfollowing example, end-user input \"I would like to rent a car\" triggers five\nexecution and transition steps:\n\n1. The executions steps viewer brings you to conversation starting page\n for the first step. In this case it's the default start page.\n\n2. Transition route for the intent `car_rental.reservation_create` is triggered.\n The executions steps viewer brings this route to focus, where you can see\n that the transition target is the `Pickup Location` page.\n\n3. Agent enters page `Pickup Location`.\n\n4. Agent evaluates the entry fulfillment of `Pickup Location` page. The\n fulfillment is empty, so nothing happens.\n\n5. Agent tries to collect the required form parameter `pickup_location` and\n the initial prompt fulfillment message for this parameter is shown to the\n end-user.\n\nYou can also undo the last utterance and try something else to test different\npage transitions.\n\nCreate a page\n-------------\n\n| **Note:** A page will not appear on the console graph until transitions have been created with a target set to the page.\n\nTo create a page: \n\n### Console\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your Google Cloud project.\n3. Select your agent.\n4. Select a flow for the page in the **Flows** section.\n5. Click the add *add* button in the **Pages** section.\n6. Enter a display name for your page.\n7. Click the settings *more_vert* button next to the page display name.\n8. Select **Edit**.\n9. Enter the fields in the page edit panel that appears.\n10. Click **Save**.\n\n### API\n\nSee the `create` method for the `Page` type.\n\n\nGo to the Page API reference \n**Select a protocol and version for the Page reference:**\n\nClose\n\n\u003cbr /\u003e\n\nPage data\n---------\n\nTo access a page's data: \n\n### Console\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose the Google Cloud project for the agent.\n3. Select your agent.\n4. Click the flow in the **Flows** section.\n5. The flow's pages are populated in the **Pages** section.\n6. Click the settings *more_vert* button next to the page display name.\n7. Select **Edit**.\n8. Enter the fields in the page edit panel that appears.\n9. Click **Save** to save any changes.\n\n### API\n\nSee the `get` and `patch/update` methods for the `Page` type.\n\n\nGo to the Page API reference \n**Select a protocol and version for the Page reference:**\n\nClose\n\n\u003cbr /\u003e\n\nThe following data is associated with pages:\n\n- **Display name**: A human-readable name for your page.\n- **Entry fulfillment** (also known as **Entry dialogue** ): This is the [fulfillment](/dialogflow/cx/docs/concept/fulfillment) to call when the page initially becomes active.\n- **Parameters** : These are the parameter values in a page [form](/dialogflow/cx/docs/concept/parameter#form) that capture structured input from the end-user.\n- **Routes** : These state handlers may be called when the page is active. For details, see [Page-level handler routes](/dialogflow/cx/docs/concept/handler#route-page)\n- **Route groups** : The routes within these groups may be called when the page is active. For details, see [Route groups](/dialogflow/cx/docs/concept/handler#route-group)\n- **Event handlers** : These event handlers may be called when the page is active. For details, see [Page-level event handlers](/dialogflow/cx/docs/concept/handler#event-page)\n\nPage settings\n-------------\n\nThe following settings are available for pages:\n\n- **Advanced speech settings** :\n These [advanced speech settings](/dialogflow/cx/docs/concept/advanced-speech)\n can optionally override the same\n [flow speech settings](/dialogflow/cx/docs/concept/flow#settings)\n and\n [agent speech settings](/dialogflow/cx/docs/concept/agent-settings#settings-speech).\n\n- **Speech adaptation settings** :\n Page level speech adaptation settings can optionally override the same\n [flow speech adaptation settings](/dialogflow/cx/docs/concept/flow#settings).\n More detailed instructions in\n [manual speech adaptation](/dialogflow/cx/docs/concept/speech-adaptation#manual-adaptation).\n\nTo access page settings: \n\n### Console\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your Google Cloud project.\n3. Select your agent.\n4. Hover your mouse over the page in the **Pages** section.\n5. Click the options *more_vert* button.\n6. Select **Page settings**.\n7. Browse or edit settings.\n8. Click **Save** to save any changes.\n\n### API\n\nSee the `get` and `patch/update` methods for the `Page` type.\n\n\nGo to the Page API reference \n**Select a protocol and version for the Page reference:**\n\nClose\n\n\u003cbr /\u003e\n\nDelete a page\n-------------\n\nTo delete a page: \n\n### Console\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your Google Cloud project.\n3. Select your agent.\n4. Select the flow for the page in the **Flows** section.\n5. Click the settings *more_vert* button next to the page display name in the **Pages** section.\n6. Select **Delete**.\n\n### API\n\nSee the `delete` method for the `Page` type.\n\n\nGo to the Page API reference \n**Select a protocol and version for the Page reference:**\n\nClose\n\n\u003cbr /\u003e"]]
