ai_function_* 세션 설정

이러한 설정은 system.settings에서 확인할 수 있으며, 소스 코드로부터 자동 생성됩니다. false(기본값)로 설정하면 AI 함수는 프롬프트와 API Key를 암호화되지 않은 연결로 원격 호스트에 전송하는 명명된 컬렉션 endpoint 사용을 거부합니다. 루프백이 아닌 호스트를 사용하는 HTTPS 이외의 모든 엔드포인트는 예외와 함께 거부됩니다. 루프백 엔드포인트(예: 로컬 http://localhost 모델 서버)는 항상 허용됩니다. 원격 호스트에서 평문 http:// 엔드포인트를 허용하려면 true로 설정하십시오. 호출에서 매개변수 맵으로 credentials를 전달하지 않을 때 임베딩 함수(aiEmbed, aiSimilarity)가 사용하는 명명된 컬렉션의 이름입니다. 비어 있으면 기본값이 없다는 뜻이며, 이런 호출에서는 credentials를 명시적으로 전달해야 합니다. 이 함수들은 model을 필수 위치 인수로 받으며, 명명된 컬렉션에서 가져오지 않습니다. 임베딩 엔드포인트는 채팅 엔드포인트와 다르므로 ai_function_text_default_credentials와는 별도로 유지됩니다. 임베딩 함수(aiEmbed, aiSimilarity)가 수행하는 단일 HTTP 요청에 포함할 수 있는 최대 텍스트 수입니다. API 호출 오버헤드를 줄이기 위해 텍스트는 이 크기의 배치로 묶입니다. 예를 들어 서로 다른 텍스트 500개와 배치 크기 100을 사용하면 HTTP 요청이 5회 발생합니다. AI 함수가 쿼리당 전송할 수 있는 HTTP 요청의 최대 개수입니다. 비활성화하려면 0으로 설정합니다. 단일 쿼리에서 모든 AI 함수 API 호출에 걸친 입력(프롬프트) 토큰의 최대 총수입니다. 이 값은 provider 응답을 기준으로 누적 추적됩니다. 호출의 입력 토큰 수는 사전에 알 수 없으므로, 이 제한은 한 번의 호출에 해당하는 입력 토큰 수만큼 초과될 수 있습니다. 비활성화하려면 0으로 설정하십시오. 이 제한은 응답에 usage 객체를 포함해 보고하는 provider(OpenAI, Anthropic, vLLM)에만 적용됩니다. 토큰 사용량을 생략하는 provider(특히 HuggingFace TEI)의 경우 카운터가 0으로 유지되므로, 이러한 호출 수를 제한하려면 대신 ai_function_max_api_calls_per_query를 사용하십시오. 단일 쿼리에서 수행되는 모든 AI 함수 API 호출에 대해, 전체 출력(completion) 토큰의 총합으로 허용되는 최대값입니다. 이 값은 provider의 응답을 기준으로 누적 추적됩니다. 호출의 출력 토큰 수는 사전에 알 수 없으므로, 이 제한은 한 번의 호출에서 생성된 출력 토큰 수만큼 초과될 수 있습니다. 비활성화하려면 0으로 설정하십시오. 이 제한은 응답에 usage 객체를 포함해 보고하는 provider(OpenAI, Anthropic, vLLM)에만 적용됩니다. 임베딩 함수(aiEmbed, aiSimilarity)에는 적용되지 않으며, 이러한 함수는 출력 토큰을 생성하지 않습니다. 개별 API 요청에서 일시적 오류가 발생했을 때의 최대 재시도 횟수입니다. 각 재시도에는 ai_function_retry_initial_delay_ms에서 시작하는 지수 백오프가 적용됩니다. AI 함수가 수행하는 개별 HTTP 요청(AI chat completions 및 임베딩 API 호출)의 시간 제한(초)입니다. 요청이 이 시간 내에 완료되지 않으면 실패한 것으로 처리되며, ai_function_max_retries에 따라 재시도될 수 있습니다. 실패한 AI 함수 API 요청을 처음 재시도하기 전의 초기 지연 시간이며, 단위는 밀리초입니다. 이후 각 시도에서는 지연 시간이 2배씩 증가합니다(지수 백오프). 예를 들어 기본 설정에서는 1000ms, 2000ms, 4000ms입니다. 텍스트 AI 함수(aiGenerate, aiClassify, aiFilter, aiExtract, aiTranslate, aiRedact) 호출에서 매개변수 맵에 credentials가 전달되지 않은 경우 사용되는 명명된 컬렉션의 이름입니다. 비어 있으면 기본값이 없다는 뜻이며, 이러한 호출에서는 credentials를 명시적으로 전달해야 합니다. chat-completions 엔드포인트는 임베딩 엔드포인트와 다르므로, 이 설정은 ai_function_embedding_default_credentials와는 별개입니다. true(기본값)이면 모든 재시도를 소진한 후에도 영구적으로 실패한 AI 함수 호출이 예외를 발생시키며 쿼리를 중단합니다. false이면 실패한 행에는 컬럼 타입의 기본값이 적용되며(String의 경우 빈 문자열), 처리는 계속됩니다. true이면(기본값) AI 함수 할당량 한도(ai_function_max_input_tokens_per_query, ai_function_max_output_tokens_per_query, 또는 ai_function_max_api_calls_per_query)를 초과할 때 예외를 발생시키고 쿼리를 중단합니다. false이면 나머지 행에는 컬럼 타입의 기본값이 적용됩니다(String은 빈 문자열).