Neste documento, descrevemos as cotas e os limites mais comuns do Dialogflow. Para saber como encontrar uma lista completa de cotas e limites, consulte as seções a seguir.
Reservamos o direito de alterar essas restrições, e esta página é atualizada para refletir qualquer mudança.
Cotas
Cotas são as restrições padrão aplicadas ao seu projeto. Ao usar recursos generativos, cada combinação de modelo e região tem a própria cota generativa. Se você estiver usando uma edição paga, poderá solicitar um aumento de cota. As cotas limitam a carga de serviço por cliente, o que protege os serviços contra sobrecarga e protege você contra o uso inesperado de recursos.
As cotas do Dialogflow variam de acordo com a edição do agente. As cotas se aplicam a cada projeto e são compartilhadas entre todos os aplicativos e endereços IP que usam um projeto.
Detalhes do limite de tempo da cota:
- As cotas mensais são renovadas no primeiro dia de cada mês às 12h (Horário do Pacífico).
- As cotas diárias são renovadas todo dia às 12h (Horário do Pacífico). Quando uma transição de horário de verão do Pacífico aumenta a duração de um dia, o Dialogflow concede um bônus de cota proporcional. No entanto, não há dedução equivalente quando um dia mais curto ocorre devido à transição do horário de verão.
- As cotas por minuto são atualizadas a cada 60 segundos no minuto.
As cotas listadas na tabela de cotas são as mais comuns. Para analisar todas as cotas, consulte a página de cotas do Dialogflow no console doGoogle Cloud .
Cotas generativas
Quando o agente usa os recursos generativos do Dialogflow CX, cada combinação de modelo e região tem cotas exclusivas.
Identificador de cota
As cotas generativas monitoram o uso de tokens para modelos de linguagem grandes (LLMs) no Dialogflow CX nos seguintes recursos:
- Geradores.
- Resposta generativa de substituição.
- Playbook.
- Repositório de dados.
O limite padrão para cotas de consumo de tokens de LLM generativo é de 600.000 tokens por minuto. O identificador de cota depende do modelo e da região:
- Modelos do Gemini 2.5 (
gemini-2.5-flashegemini-2.5-flash-lite): use a cota regional deConversationalAgentLlmTokenConsumption. - Modelos do Gemini 3 e mais recentes (como
gemini-3.1-flash-lite): use a cotaConversationalAgentMultiRegionLLMTokenConsumptionouConversationalAgentGlobalLLMTokenConsumptioncom o seguinte mapeamento regional:- Todas as regiões nos Estados Unidos usam a cota
ConversationalAgentMultiRegionLLMTokenConsumptioncommulti_region=us. - Todas as regiões da Europa usam a cota
ConversationalAgentMultiRegionLLMTokenConsumptioncommulti_region=eu. - Outras regiões (incluindo
global) usam a cotaConversationalAgentGlobalLLMTokenConsumption.
- Todas as regiões nos Estados Unidos usam a cota
Solicitação de aumento de cota multirregional
Para gemini-2.5-flash e gemini-2.5-flash-lite, que usam a cota ConversationalAgentLlmTokenConsumption, se o agente estiver em uma multirregião (us, eu ou global), envie a solicitação de aumento de cota para uma das seguintes regiões específicas:
- Para agentes nas multirregiões US e Global, use us-central1.
- Para agentes na multirregião da UE, use europe-west4.
Especificamente para a cota ConversationalAgentMultiRegionLLMTokenConsumption
usada pelo Gemini 3 e modelos posteriores, se você não encontrar a cota dimensional (como
ConversationalAgentMultiRegionLLMTokenConsumption com multi_region=us
e base_model=gemini-3.1-flash-lite) no console do Google Cloud , isso significa que você
ainda não usou essa cota ou pode enviar uma solicitação de aumento de cota usando o
seguinte comando gcloud:
PROJECT_ID=foo-test
TARGET_TPM=1000000
MULTI_REGION=us
BASE_MODEL=gemini-3.1-flash-lite
USER_EMAIL=user@example.com
REASON="Reason for requesting higher multi-region token per minute limit"
gcloud beta quotas preferences create \
--service=dialogflow.googleapis.com \
--project="${PROJECT_ID}" \
--billing-project="${PROJECT_ID}" \
--quota-id=ConversationalAgentMultiRegionLLMTokensPerMinutePerBaseModel \
--preferred-value=${TARGET_TPM} \
--dimensions=multi_region=${MULTI_REGION},base_model=${BASE_MODEL} \
--email="${USER_EMAIL}" \
--justification="${REASON}"
Visualizar o uso de tokens por região e modelo
Para ter insights sobre o consumo de tokens de LLM em diferentes regiões e modelos, siga estas etapas usando o Metrics Explorer:
- Acesse o Metrics Explorer:abra o Metrics Explorer.
- Selecione a métrica:escolha
Conversational Agent LLM tokens quota usagecomo a métrica que você quer analisar. - Configurar a agregação e o alinhador:
- Defina a função de agregação como
Sumpara ver o uso total de tokens. - Selecione
Configure Alignerpara calcular as mudanças entre pontos de dados consecutivos na série temporal. Assim, fica mais fácil entender as tendências de uso ao longo do tempo.
- Defina a função de agregação como
- Defina as dimensões de agregação:para detalhar o uso de tokens, selecione
locationebase_modelcomo as dimensões de agregação. O consumo de tokens varia de acordo com as regiões e os modelos. - Definir a função do alinhador:selecione
Sumcomo a função do alinhador para calcular a mudança total no uso de tokens entre pontos de dados consecutivos.
Solicitação de aumento de cota
Se necessário, é possível solicitar um ajuste de aumento de cota.
Se você usa projetos diferentes para agentes do Dialogflow e para autenticação com contas de serviço, solicite um aumento de cota para o projeto do consumidor. Para mais informações, consulte Como usar vários projetos para o Dialogflow ES ou Como usar vários projetos para o Dialogflow CX.
Para agentes do Dialogflow ES, é necessário fazer upgrade do agente para a edição Dialogflow Essentials antes de solicitar um aumento de cota.
Tabela de cotas
Os termos a seguir são usados para descrever os preços e as cotas:
- Solicitação:uma solicitação é definida como qualquer chamada de API para o serviço do Dialogflow CX, seja direta com o uso da API ou indireta com o uso da integração ou do console. Dependendo da tarefa e do design do agente, o número de solicitações necessárias para que um usuário final conclua uma tarefa com um agente de CX do Dialogflow CX pode variar muito.
- Sessão:uma sessão é uma conversa entre um usuário final e um agente de CX do Dialogflow CX.
Uma sessão permanece ativa e os dados dela são armazenados por 30 minutos após a última solicitação ser enviada para a sessão.
Ela pode ser uma sessão de chat ou uma sessão por chamada de voz.
- Sessão de chat:uma sessão de chat usa apenas texto para solicitações e respostas.
- Sessão por ligação: uma sessão por ligação usa áudio para solicitações, respostas ou ambos.
- Projetos do consumidor e projetos de recursos: se você usar vários projetos, será possível que o projeto associado à sua autenticação de solicitação (projeto do consumidor) não seja o mesmo projeto que está associado ao agente na solicitação (projeto de recurso). Nesse caso, o projeto do consumidor é usado para determinar preços e cotas. Para mais informações, consulte Como usar vários projetos para o Dialogflow ES ou Como usar vários projetos para o Dialogflow CX.
A tabela a seguir oferece uma comparação de cotas das edições por tipo de agente. As cotas serão cumulativas para todos os recursos usados por uma solicitação, a menos que um recurso seja indicado como incluído.
Agente do Dialogflow CX
| Recurso | Dialogflow CX Edition |
|---|---|
|
Texto (inclui todas as solicitações DetectIntent, StreamingDetectIntent e FulfillIntent que não contêm áudio) |
1.200 solicitações por minuto |
|
Entrada/saída de áudio (reconhecimento de fala, conversão de voz em texto, STT, síntese de fala, conversão de texto em voz, TTS e telefonia) |
600 solicitações por minuto |
|
Operações de consulta de áudio com a voz em alta definição do Chirp 3 (síntese de voz, conversão de texto em voz, TTS, telefonia) |
25 solicitações por minuto * |
|
Recursos generativos (playbooks, repositórios de dados, geradores, resposta generativa de substituição) |
600.000 tokens por minuto, consulte cotas generativas |
|
Gateway telefônico do Dialogflow CX Inclui entrada e saída de áudio. |
Total de 100 minutos de chamada por minuto ‡ |
|
Solicitações de gravação em tempo de design Por exemplo, chamadas para criar ou atualizar um agente. |
60 solicitações por minuto |
|
Solicitações de leitura em tempo de design Por exemplo, chamadas para listar ou receber recursos do agente. |
300 solicitações por minuto |
|
Solicitações de outras sessões Por exemplo, configurar ou receber entidades da sessão. |
100 solicitações por minuto |
| Symbol | Descrição |
|---|---|
| * | Se a cota for excedida, as vozes em alta definição do Chirp 3 poderão ser substituídas por vozes neurais ou padrão. |
| ‡ | "Minutos de chamada por minuto" é a soma total do tempo por minuto usado por todos os usuários em chamadas no sistema telefônico. Por exemplo: em um período de 60 segundos, um usuário está on-line por 60 segundos, outro por 30 segundos e um terceiro por mais 30 segundos. Essa soma resulta em dois minutos por minuto. Com um valor maior, mais usuários podem usar o sistema ao mesmo tempo. |
Agente do Dialogflow ES
| Recurso | Edição de teste | Edição Essentials |
|---|---|---|
|
Texto (inclui todas as solicitações DetectIntent e StreamingDetectIntent que não contêm áudio) |
180 solicitações por minuto ¶ | 600 solicitações por minuto ¶ |
|
Entrada de áudio (também conhecida como reconhecimento de fala, conversão de voz em texto e STT) |
100 solicitações por minuto † 1.000 solicitações por dia † 15.000 solicitações por mês † Máximo de 60 segundos de duração de áudio por solicitação † |
300 solicitações por minuto † Máximo de 60 segundos de duração de áudio por solicitação † |
|
Saída de áudio (também conhecida como síntese de fala, conversão de texto em voz e TTS) |
Igual à entrada de áudio | Igual à entrada de áudio |
| Conectores de conhecimento (Beta) | Máximo de 10 MB no tamanho do documento 1.000 solicitações por mês 100 solicitações por dia |
Sem limites # |
| Análise de sentimento | Indisponível | Sem limites # |
|
Gateway de telefone do Dialogflow ES Inclui entrada e saída de áudio. |
Número para chamada sem custo financeiro: indisponível 3 minutos de ligação por minuto ‡ 30 minutos de ligação por dia 500 minutos de ligação por mês Número de telefone reservado por 30 dias |
Total de 100 minutos de chamada por minuto ‡ |
| Mega-agente | 1.000 solicitações por dia | Sem limites # |
|
Solicitações de gravação em tempo de design Por exemplo, chamadas para criar ou atualizar um agente. |
60 solicitações por minuto | 60 solicitações por minuto |
|
Solicitações de leitura em tempo de design Por exemplo, chamadas para listar ou receber recursos do agente. |
60 solicitações por minuto | 60 solicitações por minuto |
|
Solicitações de outras sessões Por exemplo, definir ou receber entidades da sessão ou atualizar/consultar o contexto. |
100 solicitações por minuto | 100 solicitações por minuto |
| Symbol | Descrição |
|---|---|
| † | Cada stream StreamingDetectIntent é considerado uma única solicitação, mesmo que ele inclua vários frames de áudio StreamingDetectIntentRequest. |
| ‡ | "Minutos de chamada por minuto" é a soma total do tempo por minuto usado por todos os usuários em chamadas no sistema telefônico. Por exemplo: em um período de 60 segundos, um usuário está on-line por 60 segundos, outro por 30 segundos e um terceiro por mais 30 segundos. Essa soma resulta em dois minutos por minuto. Com um valor maior, mais usuários podem usar o sistema ao mesmo tempo. |
| # | Os recursos marcados como sem limites podem ser limitados pelo uso de outros recursos. Por exemplo, mesmo que sua edição ofereça uma cota ilimitada para conectores de conhecimento, uma solicitação de texto que usa esse componente ainda será limitada pela cota da solicitação de texto. |
| ¶ | As entradas e saídas de áudio do Google Assistente são consideradas como solicitações de texto. |
Agent Assist
Se você estiver usando o Agent Assist, as cotas listadas nas guias Agente do Dialogflow CX e Agente do Dialogflow ES também se aplicam, de acordo com o tipo de agente que você está usando.
| Recurso | Edição de teste | Edição Essentials |
|---|---|---|
|
Outras operações do Agent Assist Inclui todas as solicitações que gerenciam conversas e participantes. |
Indisponível | 300 solicitações por minuto |
|
Operações de análise de texto/áudio do Agent Assist Inclui todas as solicitações AnalyzeContent ou StreamingAnalyzeContent para qualquer estágio de conversa. Isso inclui todas as solicitações que envolvem texto, síntese de fala e/ou reconhecimento de fala. |
Indisponível | 300 solicitações por minuto |
|
Sessões de streaming bidirecional simultâneas Inclui todas as solicitações BidiStreamingAnalyzeContent para qualquer estágio de conversa. Isso inclui todas as solicitações que envolvem síntese e/ou reconhecimento de fala. |
Indisponível | 50 solicitações simultâneas |
|
Solicitações de sondagem de sugestões de resumo da conversa do Agent Assist Inclui todas as solicitações para receber resumos da conversa. |
Indisponível | 60 solicitações por minuto |
|
Solicitações SearchKnowledge do Agent Assist Inclui todas as solicitações SearchKnowledge para qualquer estágio da conversa. |
Indisponível | 60 solicitações por minuto |
Limites
Os limites são restrições fixas que não podem ser aumentadas. Muitos recursos e campos têm limitações de contagem, duração ou comprimento, que são restrições fixas para a implementação do serviço.
As tabelas a seguir listam os limites que normalmente são encontrados. A documentação específica do recurso e a documentação de referência da API podem fornecer limites adicionais.
Limites de contagem
Agente do Dialogflow CX
| Descrição | Limite |
|---|---|
| Número máximo de agentes por projeto do Google Cloud | 1000 |
Número máximo de números de telefone por projeto (exceto para a região global) |
5 |
Número máximo de números de telefone por projeto por região (exceto para a região global) |
5 |
| Número máximo de fluxos por agente | 50 |
| Número máximo de tipos de entidade por agente | 250 |
| Número máximo de webhooks por agente | 100 |
| Número máximo de ambientes por agente | 20 |
| Número máximo de casos de teste por agente | 2000 |
| Número máximo de registros de alterações por agente | 20.000 |
| Número máximo de páginas por fluxo | 250 |
| Número máximo de grupos de rotas por fluxo | 100 |
| Número máximo de versões por fluxo | 20 |
| Número máximo de intents por agente | 10.000 |
| Número máximo de intents referenciadas por fluxo | 2000 |
| Número máximo de frases de treinamento por intent e por idioma (exceto "Intent negativa padrão") | 2000 |
| Número máximo de frases de treinamento por fluxo e por idioma | 100.000 |
| Número máximo de parâmetros por intent | 20 |
| Número máximo de entradas de entidade por entidade | 30.000 |
| Número máximo de sinônimos de entidade por entrada de entidade | 200 |
| Número máximo de valores de referência e sinônimos de entidade por agente e por idioma | 1.000.000 |
| Número máximo de parâmetros por página | 20 |
| Número máximo de rotas por página | 2000 |
| Número máximo de manipuladores de eventos por página | 100 |
| Número máximo de rotas por grupo de rotas | 2000 |
| Número máximo de playbooks por agente | 50 |
| Número máximo de invocações de playbook em uma rodada de conversa | 3 |
| Número máximo de chamadas de LLM por invocação de playbook na mesma rodada de conversa | 10 |
| Número máximo de exemplos de playbook por agente | Com a estratégia padrão de recuperação de exemplos, o sistema limita automaticamente o número de exemplos para se ajustar ao limite de tokens do modelo que está sendo usado, com base na relevância dos exemplos para o contexto da sessão. |
| Número máximo de versões por playbook | 100 |
| Número máximo de ferramentas por agente | 100 |
| Número máximo de etapas por conversa | 100 |
Agente do Dialogflow ES
| Descrição | Limite |
|---|---|
| Número máximo de agentes por região e por projeto do Google Cloud ¶ | 1 |
Número máximo de números de telefone por projeto (exceto para a região global) |
5 |
Número máximo de números de telefone por projeto por região (exceto para a região global) |
5 |
| Número máximo de intents | 2.000 |
| Número máximo de tipos de entidade | 250 |
| Número máximo de frases de treinamento por intent e por idioma | 2000 |
| Número máximo de frases de treinamento por agente e por idioma | 100.000 |
| Número máximo de entradas de entidade | 30.000 |
| Número máximo de sinônimos por entrada de entidade | 200 |
| Número máximo de valores de referência e sinônimos de entidade por agente e por idioma | 1.000.000 |
| Número máximo de parâmetros por intent | 20 |
| Número máximo de contextos de entrada por intent | 5 |
| Número máximo de contextos de saída por intent | 30 |
| Número máximo de respostas de texto por intent e por idioma | 30 |
| Número máximo de comandos por parâmetro e por idioma | 30 |
| Número máximo de ambientes por agente | 10 |
| Número máximo de versões por agente | 1000 |
| ¶ | O número máximo de agentes por conta depende do número de projetos do Google que você pode criar na sua conta. Veja como solicitar mais projetos. |
Agent Assist
Se você estiver usando o Agent Assist, os limites listados nas guias Agente do Dialogflow CX e Dialogflow ES também serão aplicados de acordo com o tipo de agente que você está usando.
| Descrição | Limite |
|---|---|
| Número mínimo de conversas necessárias para treinamento do modelo | 30.000 |
| Número máximo de modelos treinados simultaneamente por projeto | 1 |
Número máximo de números de telefone por projeto (exceto para a região global) |
5 |
Número máximo de números de telefone por projeto por região (exceto para a região global) |
5 |
| Número máximo de horas de GPU do nó de treinamento por mês | 4200 |
| Número máximo de perfis de conversa | 100 |
Limites de duração
Agente do Dialogflow CX
| Descrição | Limite |
|---|---|
| Tempo limite máximo por webhook | 30 segundos |
| Duração máxima da entrada de áudio | 120 segundos |
Agente do Dialogflow ES
| Descrição | Limite |
|---|---|
| Tempo limite máximo do webhook | 5 segundos |
| Duração máxima das chamadas telefônicas | 3,5 horas |
Limites de tamanho
Agente do Dialogflow CX
| Descrição | Limite |
|---|---|
| Tamanho máximo da frase de treinamento | 768 caracteres |
| Tamanho máximo da resposta de texto | 4.000 caracteres |
| Tamanho máximo da entrada de texto para detecção de intent correspondente a intents não generativas ou parâmetros | 256 caracteres |
Agente do Dialogflow ES
| Descrição | Limite |
|---|---|
| Tamanho mínimo do nome do agente | 1 caractere |
| Tamanho máximo do nome do agente | 150 caracteres |
| Tamanho máximo da descrição do agente | 500 caracteres |
| Tamanho máximo do nome da intent | 100 caracteres |
| Tamanho máximo do nome do tipo da entidade | 30 caracteres |
| Tamanho máximo da frase de treinamento | 768 caracteres |
| Tamanho máximo do nome da ação | 250 caracteres |
| Tamanho máximo do nome de contexto | 250 caracteres |
| Tamanho máximo do valor de entrada | 512 caracteres |
| Tamanho máximo do nome do parâmetro | 30 caracteres |
| Tamanho máximo da resposta de texto | 4.000 caracteres |
| Tamanho máximo da entrada de texto de detecção de intent * | 256 caracteres |
| Tamanho máximo do nome do evento | 150 caracteres |
| * | Esse limite é aplicado pelo serviço do Dialogflow. Caso você esteja usando uma integração, a plataforma pode ter um limite menor. Veja os detalhes para sua integração. |
Limites de tamanho
Agente do Dialogflow CX
| Descrição | Limite |
|---|---|
| Tamanho máximo da solicitação de síntese de voz | Consulte os limites de conteúdo da API TTS. |
| Tamanho máximo das especificações da ferramenta | 20KB |
Agente do Dialogflow ES
| Descrição | Limite |
|---|---|
| Tamanho máximo do agente (conteúdo descompactado) para importação/restauração do agente | 50 MB |
| Tamanho máximo da solicitação de síntese de voz | Consulte os limites de conteúdo da API TTS. |