Update Ai Configuration
PUT /api/v1/admin/ai-config
PUT
/api/v1/admin/ai-config
Update AI configuration.
Super admin only.
- Updates any configuration field
- Validates values before saving
- API keys are only updated if not masked
Authorizations
Seção intitulada “Authorizations ”Request Body required
Seção intitulada “Request Body required ” AIConfigurationUpdate
Schema for updating AI Configuration.
All fields are optional - only specified fields will be updated. Validation is performed by AIConfigurationService.
object
buffer_urgent_words
Any of:
Array<string>
null
buffer_closing_words
Any of:
Array<string>
null
blocked_topics
Any of:
Array<string>
null
Responses
Seção intitulada “ Responses ”Successful Response
AIConfigurationResponse
Schema for AI Configuration response.
API keys are automatically masked for security.
object
id
required
Id
integer
created_at
required
Created At
string format: date-time
updated_at
required
Updated At
string format: date-time
enable_ai_features
required
Enable Ai Features
boolean
enable_chat_assistants
required
Enable Chat Assistants
boolean
enable_custom_assistants
required
Enable Custom Assistants
boolean
enable_knowledge_base
required
Enable Knowledge Base
boolean
enable_rag
required
Enable Rag
boolean
enable_agents
required
Enable Agents
boolean
enable_channel_autoresponse
required
Enable Channel Autoresponse
boolean
enable_memory
required
Enable Memory
boolean
enable_learning
required
Enable Learning
boolean
enable_external_sources
required
Enable External Sources
boolean
default_provider
required
Default Provider
string
default_model
required
Default Model
string
embedding_model
required
Embedding Model
string
context_budget_default
required
Context Budget Default
integer
context_budget_max
required
Context Budget Max
integer
max_output_tokens
required
Max Output Tokens
integer
max_conversation_tokens
required
Max Conversation Tokens
integer
buffer_enabled
required
Buffer Enabled
boolean
buffer_timeout_seconds
required
Buffer Timeout Seconds
integer
buffer_max_messages
required
Buffer Max Messages
integer
buffer_max_chars
required
Buffer Max Chars
integer
buffer_urgent_words
required
Buffer Urgent Words
Array<string>
buffer_closing_words
required
Buffer Closing Words
Array<string>
rag_prefetch_mode
required
Rag Prefetch Mode
string
rag_min_relevance
required
Rag Min Relevance
number
rag_max_chunks_prefetch
required
Rag Max Chunks Prefetch
integer
rag_max_chunks_tool
required
Rag Max Chunks Tool
integer
rag_chunk_size
required
Rag Chunk Size
integer
rag_chunk_overlap
required
Rag Chunk Overlap
integer
rag_max_content_chars
required
Rag Max Content Chars
integer
rag_require_citations
required
Rag Require Citations
boolean
tool_max_result_chars
required
Tool Max Result Chars
integer
memory_max_per_agent
required
Memory Max Per Agent
integer
memory_max_in_prompt
required
Memory Max In Prompt
integer
memory_short_term_hours
required
Memory Short Term Hours
integer
memory_episodic_days
required
Memory Episodic Days
integer
memory_consolidation_hours
required
Memory Consolidation Hours
integer
memory_min_importance
required
Memory Min Importance
number
memory_extraction_enabled
required
Memory Extraction Enabled
boolean
memory_extraction_model
required
Memory Extraction Model
string
temperature_default
required
Temperature Default
number
temperature_factual
required
Temperature Factual
number
temperature_creative
required
Temperature Creative
number
max_react_iterations
required
Max React Iterations
integer
max_tools_per_turn
required
Max Tools Per Turn
integer
tool_timeout_seconds
required
Tool Timeout Seconds
integer
rate_limit_per_user_day
required
Rate Limit Per User Day
integer
rate_limit_per_tenant_min
required
Rate Limit Per Tenant Min
integer
rate_limit_per_agent_hour
required
Rate Limit Per Agent Hour
integer
cost_alert_daily_usd
required
Cost Alert Daily Usd
number
cost_limit_daily_usd
required
Cost Limit Daily Usd
number
cost_alert_monthly_usd
required
Cost Alert Monthly Usd
number
cost_limit_monthly_usd
required
Cost Limit Monthly Usd
number
cost_alert_percent
required
Cost Alert Percent
integer
content_filter_level
required
Content Filter Level
string
blocked_topics
required
Blocked Topics
Array<string>
require_human_handoff
required
Require Human Handoff
boolean
max_auto_responses
required
Max Auto Responses
integer
cache_embeddings_hours
required
Cache Embeddings Hours
integer
cache_rag_minutes
required
Cache Rag Minutes
integer
timeout_llm_seconds
required
Timeout Llm Seconds
integer
timeout_total_seconds
required
Timeout Total Seconds
integer
log_prompts
required
Log Prompts
boolean
log_responses
required
Log Responses
boolean
log_tool_calls
required
Log Tool Calls
boolean
log_retention_days
required
Log Retention Days
integer
disabled_feature_behavior
Disabled Feature Behavior
How to display disabled features: ‘hide’ or ‘show_disabled’
string
Validation Error
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string