Este documento descreve as cotas e os limites comuns do Dialogflow. Para saber como encontrar uma lista completa de cotas e limites, consulte as seções a seguir.
Reservamos o direito de mudar 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 uma cota generativa própria. 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 você contra o uso inesperado de recursos.
As cotas do Dialogflow variam de acordo com a edição do seu 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 do horário de verão do horário do Pacífico aumenta a duração de um dia, o Dialogflow concede um bônus de cota proporcional. No entanto, não há uma dedução equivalente quando um dia mais curto ocorre devido à transição para o 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 revisar todas as cotas, consulte a página 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 rastreiam 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 generativos é 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 regionalConversationalAgentLlmTokenConsumption. - Modelos do Gemini 3 e mais recentes (como
gemini-3.1-flash-lite): use a cotaConversationalAgentMultiRegionLLMTokenConsumptionouConversationalAgentGlobalLLMTokenConsumptioncom o seguinte mapeamento regional:- Todas as regiões dos 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 dos Estados Unidos usam a cota
Solicitação de aumento de cota em várias regiões
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 de ConversationalAgentMultiRegionLLMTokenConsumption usada pelos modelos do Gemini 3 e mais recentes, 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}" \
--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:
- Acessar 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 agregação e alinhador:
- Defina a função de agregação como
Sumpara saber o uso total de tokens. - Selecione
Configure Alignerpara calcular as mudanças entre pontos de dados consecutivos na sua 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
- Definir 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 função de alinhamento:selecione
Sumcomo a função de alinhamento 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ê usar projetos diferentes para agentes do Dialogflow e para autenticação com contas de serviço, solicite um aumento de cota para o projeto consumidor. Para mais informações, consulte Usar vários projetos no Dialogflow ES ou Usar vários projetos no Dialogflow CX.
Para agentes do Dialogflow ES, é necessário fazer upgrade do agente para a edição do 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 do Dialogflow CX pode variar muito.
- Sessão:uma sessão é uma conversa entre um usuário final e um agente 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 no Dialogflow ES ou Como usar vários projetos no 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 as 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 no momento do design Por exemplo, chamadas para criar ou atualizar um agente. |
60 solicitações por minuto |
|
Solicitações de leitura no momento do 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 HD do Chirp 3 poderão voltar para as 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 # |
|
Dialogflow ES Phone Gateway Inclui entrada e saída de áudio. |
Número sem custo financeiro: não disponível 3 minutos de telefone por minuto ‡ 30 minutos de telefone por dia 500 minutos de telefone 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 no momento do design Por exemplo, chamadas para criar ou atualizar um agente. |
60 solicitações por minuto | 60 solicitações por minuto |
|
Solicitações de leitura no momento do 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 serão aplicadas, 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 etapa da conversa. Isso inclui todas as solicitações envolvendo texto, síntese de voz e/ou reconhecimento de fala. |
Indisponível | 300 solicitações por minuto |
|
Sessões simultâneas de streaming bidirecional Inclui todas as solicitações BidiStreamingAnalyzeContent para qualquer estágio da conversa. Isso inclui todas as solicitações envolvendo síntese e/ou reconhecimento de fala. |
Indisponível | 50 solicitações simultâneas |
|
Solicitações de pesquisa de sugestões de resumo da conversa do Agent Assist Inclui todas as solicitações para receber resumos de conversa. |
Indisponível | 60 solicitações por minuto |
|
Solicitações do Agent Assist SearchKnowledge Inclui todas as solicitações do SearchKnowledge para qualquer etapa 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 Google Cloud | 1000 |
Número máximo de números de telefone por projeto (exceto na região global) |
5 |
Número máximo de números de telefone por projeto por região (exceto 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 changelogs 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 no mesmo turno de conversa | 10 |
| Número máximo de exemplos de playbook por agente | Com a estratégia de recuperação de exemplos padrão, o sistema limita automaticamente o número de exemplos para se ajustar ao limite de tokens do modelo 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 Google Cloud ¶ | 1 |
Número máximo de números de telefone por projeto (exceto na região global) |
5 |
Número máximo de números de telefone por projeto por região (exceto 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 de entidade e sinônimos 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 intenção 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 Dialogflow CX e Dialogflow ES também se aplicam de acordo com o tipo de agente que você está usando.
| Descrição | Limite |
|---|---|
| Número mínimo de conversas necessárias para o treinamento de 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 na região global) |
5 |
Número máximo de números de telefone por projeto por região (exceto 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 |
| Comprimento máximo da entrada de texto para detecção de intenção correspondente a intenções 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. |