Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Se você não estiver usando uma das opções de integração, escreva um código que interaja diretamente com o usuário final.
Você também precisa interagir diretamente
com a API do Dialogflow
em cada turno da conversa
para enviar expressões do usuário final e receber correspondências de intent.
O diagrama a seguir mostra o fluxo de processamento ao interagir com a API.
O usuário final digita ou fala uma expressão.
O serviço envia essa expressão de usuário final para o Dialogflow em uma mensagem de solicitação de intent de detecção.
O Dialogflow, por sua vez, envia uma mensagem de resposta com intent de detecção ao seu serviço.
Essa mensagem contém informações sobre a intent correspondida, a ação, os parâmetros e a resposta definida para a intent.
O serviço toma as medidas necessárias, como consultas de banco de dados ou chamadas de API externas.
O serviço envia uma resposta para o usuário final.
O usuário final vê ou ouve a resposta.
Configuração e autenticação do projeto
Antes de chamar a API, você precisa configurar um projeto e uma autenticação do GCP.
É possível seguir as etapas no Guia de início rápido de configuração.
Construção de agentes
Na maioria dos casos, é necessário usar o console do Dialogflow ES (acesse a documentação, abra o console) para criar agentes.
Siga as etapas na página de início rápido do Console para criar um agente.
Também é possível usar a API do Dialogflow para criar agentes para cenários avançados.
Muitas páginas de conceito se concentram no uso do console para criar agentes, mas também fornecem links para tipos de API relevantes.
REST, gRPC e bibliotecas de cliente
Acesse a API do Dialogflow via REST, gRPC ou uma das bibliotecas de cliente fornecidas.
Para saber mais sobre essas opções, consulte a visão geral do uso da API.
Sessões
Uma sessão representa uma conversa entre um agente do Dialogflow e um usuário final.
Você cria uma sessão no início de uma conversa e a usa a cada fala.
Depois que a conversa terminar, você deixará de usar a sessão.
Não use a mesma sessão para conversas simultâneas com diferentes usuários finais.
No momento, o Dialogflow mantém os contextos ativos para cada sessão ativa.
Ele armazena os dados da sessão por 20 minutos.
Cada sessão é determinada de forma exclusiva por um ID de sessão gerado pelo sistema.
Crie uma nova sessão fornecendo um novo ID de sessão em uma solicitação de detecção de intent.
Um ID de sessão é uma string de no máximo 36 bytes.
Seu sistema é responsável por gerar IDs de sessão exclusivos.
Eles podem ser números aleatórios, identificadores de usuário final com hash ou qualquer outro valor conveniente para a geração.
Detectar intent
Quando você usa a API para interações, seu serviço interage diretamente com o usuário final.
Para cada fala na conversa, o serviço envia expressões de usuário final para o Dialogflow chamando o método detectIntent ou streamingDetectIntent do tipo Sessions.
O Dialogflow responde com informações sobre a intent correspondente, a ação, os parâmetros e a resposta definida para a intent.
Seu serviço executa ações conforme necessário (por exemplo, consultas de banco de dados ou chamadas de API externas) e envia uma mensagem para o usuário final.
Esse processo continua até que a conversa termine.
[[["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\u003eWhen not using pre-built integrations, direct interaction with Dialogflow's API is required for each conversational turn to process end-user input and receive intent matches.\u003c/p\u003e\n"],["\u003cp\u003eInteractions with the Dialogflow API follow a process where the service sends user expressions, Dialogflow returns intent data, and the service then performs actions and replies to the user.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, users need to set up a GCP project and authentication, which can be done through the provided setup quickstart.\u003c/p\u003e\n"],["\u003cp\u003eA session represents a conversation with an end-user, initiated with a unique session ID, and this ID should not be used for multiple concurrent conversations.\u003c/p\u003e\n"],["\u003cp\u003eTo interact, the service calls the \u003ccode\u003edetectIntent\u003c/code\u003e method to send the user's expressions to Dialogflow, which will respond with data about matched intents.\u003c/p\u003e\n"]]],[],null,["# API interactions\n\nIf you are not using one of the\n[integration](/dialogflow/docs/integrations)\noptions,\nyou must write code that directly interacts with the end-user.\nYou must also directly\n\ninteract with Dialogflow's API\n\nfor each conversational turn\nto send end-user expressions and receive intent matches.\nThe following diagram shows the processing flow when interacting with the API.\n\n1. The end-user types or speaks an expression.\n2. Your service sends this end-user expression to Dialogflow in a detect intent request message.\n3. Dialogflow sends a detect intent response message to your service. This message contains information about the matched intent, the action, the parameters, and the response defined for the intent.\n4. Your service performs actions as needed, like database queries or external API calls.\n5. Your service sends a response to the end-user.\n6. The end-user sees or hears the response.\n\nProject setup and authentication\n--------------------------------\n\nBefore calling the API,\nyou need to set up a GCP project and authentication.\nYou can follow the steps in the\n[Setup quickstart](/dialogflow/docs/quick/setup).\n\nAgent building\n--------------\n\nIn most cases you should use the Dialogflow ES console ([visit documentation](/dialogflow/docs/console), [open console](https://dialogflow.cloud.google.com)) to build agents.\nYou can follow the steps in the\n[console quickstart page](/dialogflow/docs/quick/build-agent)\nto create an agent.\nYou can also use the Dialogflow API to build agents for advanced scenarios.\nMany\n[concept pages](/dialogflow/docs/concepts)\nfocus on using the console to build agents,\nbut they also provide links to relevant API types.\n\nREST, gRPC, and client libraries\n--------------------------------\n\nYou can access the Dialogflow API via REST, gRPC,\nor one of the provided client libraries.\nFor the details on these options,\nsee the\n[API usage overview](/dialogflow/docs/reference/api-overview).\n\nSessions\n--------\n\n\nA *session* represents a conversation between a Dialogflow agent and an end-user.\nYou create a session at the beginning of a conversation\nand use it for each turn of the conversation.\nOnce the conversation has ended, you discontinue using the session.\n\n\nYou should not use the same session for\nconcurrent conversations with different end-users.\nDialogflow maintains the currently active contexts for each active session.\nSession data is stored by Dialogflow for 20 minutes.\n\n\nEach session is determined unique by a session ID generated by your system.\nYou create a new session by providing a new session ID in a\n[detect intent request](/dialogflow/docs/api-overview#detect-intent).\nA session ID is a string of at most 36 bytes in size.\nYour system is responsible for generating unique session IDs.\nThey can be random numbers, hashed end-user identifiers,\nor any other values that are convenient for you to generate.\n\nDetect intent\n-------------\n\n\nWhen you use the API for interactions,\nyour service interacts directly with the end-user.\nFor each conversational turn,\nyour service sends end-user expressions to Dialogflow by calling the\n`detectIntent` or `streamingDetectIntent` method of the\n[`Sessions`](/dialogflow/docs/reference/common-types#sessions)\ntype.\nDialogflow responds with information about the matched intent,\nthe action, the parameters, and the response defined for the intent.\nYour service performs actions as needed\n(for example, database queries or external API calls)\nand sends a message to the end-user.\nThis process continues until the conversation has ended.\n\nYou can find examples of calling detect intent in the\n[API quickstart page](/dialogflow/docs/quick/api)\nand the\n[how-to pages](/dialogflow/docs/how)."]]
