> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# configurações de sessão ai_function_*
> Configurações de sessão do ClickHouse no grupo ai_function_* gerado.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Tipo
{type}
Padrão
{default_value}
{changeable_without_restart &&
Pode ser alterado sem reiniciar
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
export const ExperimentalBadge = () => {
return ;
};
Essas configurações estão disponíveis em [system.settings](/docs/pt-BR/reference/system-tables/settings) e são autogeradas a partir do [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## ai\_function\_embedding\_default\_credentials
Nome da coleção nomeada usada por `aiEmbed` quando a chamada não fornece `credentials` no mapa de parâmetros. Vazio significa que não há valor padrão: essas chamadas devem fornecer `credentials` explicitamente. `aiEmbed` usa `model` como argumento posicional obrigatório, e não a partir da coleção nomeada. Isso é mantido separado de `ai_function_text_default_credentials` porque um endpoint de embeddings é diferente de um endpoint de chat.
## ai\_function\_embedding\_max\_batch\_size
Número máximo de textos a serem incluídos em uma única requisição HTTP feita pelo `aiEmbed`. Os textos são agrupados em lotes desse tamanho para reduzir a sobrecarga das chamadas de API. Por exemplo, 500 textos únicos com lote de 100 resultam em 5 requisições HTTP.
## ai\_function\_max\_api\_calls\_per\_query
Número máximo de requisições HTTP que as funções de IA podem encaminhar em uma consulta. Defina como 0 para desabilitar.
## ai\_function\_max\_input\_tokens\_per\_query
Número máximo total de tokens de entrada (`prompt`) em todas as chamadas de API da função de IA em uma única consulta. O total é contabilizado de forma cumulativa com base nas respostas dos provedores. Observe que esse limite pode ser excedido pelo volume de tokens de entrada de uma chamada, já que o número de tokens de entrada de uma chamada não é conhecido antecipadamente. Defina como 0 para desativar.
Esse limite só é aplicado a provedores que informam um objeto `usage` na resposta (OpenAI, Anthropic, vLLM). Provedores que omitem o uso de tokens (principalmente o HuggingFace TEI) fazem com que o contador permaneça em 0 — use `ai_function_max_api_calls_per_query` para limitar essas chamadas.
## ai\_function\_max\_output\_tokens\_per\_query
Máximo total de tokens de saída (completion) em todas as chamadas de API da função de IA em uma única consulta. O rastreamento é cumulativo com base nas respostas do provedor. Observe que esse limite pode ser excedido pelo volume de tokens de saída de uma chamada, já que o número de tokens de saída de uma chamada não é conhecido antecipadamente. Defina como 0 para desativar.
Esse limite só é aplicado a provedores que informam um objeto `usage` na resposta (OpenAI, Anthropic, vLLM). Ele não se aplica a funções de embedding (em especial aiEmbed), que nunca produzem tokens de saída.
## ai\_function\_max\_retries
Número máximo de retentativas para erros transitórios por solicitação individual à API. Cada retentativa usa backoff exponencial a partir de `ai_function_retry_initial_delay_ms`.
## ai\_function\_request\_timeout\_sec
Timeout em segundos para requisições HTTP individuais feitas por funções de IA (completions de chat com IA e chamadas à API de embedding). Se uma requisição não for concluída dentro desse tempo, ela será considerada malsucedida e poderá ser repetida de acordo com `ai_function_max_retries`.
## ai\_function\_retry\_initial\_delay\_ms
Atraso inicial, em milissegundos, antes da primeira nova tentativa de uma solicitação de API com falha da função de IA. O atraso dobra a cada tentativa subsequente (backoff exponencial). Por exemplo, com as configurações padrão: 1000ms, 2000ms, 4000ms.
## ai\_function\_text\_default\_credentials
Nome da coleção nomeada usada pelas funções de IA de texto (`aiGenerate`, `aiClassify`, `aiExtract`, `aiTranslate`) quando a chamada não fornece `credentials` no mapa de parâmetros. Vazio significa que não há padrão: essas chamadas devem fornecer `credentials` explicitamente. Um endpoint de chat completions é diferente de um de embeddings, portanto isso é separado de `ai_function_embedding_default_credentials`.
## ai\_function\_throw\_on\_error
Se true (padrão), uma chamada de função de IA que falhar permanentemente após esgotar todas as tentativas interrompe a consulta com uma exceção. Se false, a linha com falha recebe o valor padrão para o tipo da coluna (string vazia para String), e o processamento continua.
## ai\_function\_throw\_on\_quota\_exceeded
Se true (padrão), exceder um limite de cota de uma função de IA (`ai_function_max_input_tokens_per_query`, `ai_function_max_output_tokens_per_query` ou `ai_function_max_api_calls_per_query`) interrompe a consulta com uma exceção. Se false, as linhas restantes recebem o valor padrão do tipo de coluna (string vazia para String).