Skip to content

Limits and defaults

These are the limits and defaults VirtuAI applies today. They can change as the product evolves; the release notes mention changes that affect you.

Item Limit or default
Agent ID Letters, numbers, hyphens and underscores only; up to 100 characters; must be unique
Agent name 1 to 200 characters
Personality At least 10 characters
Channels At least one channel must be turned on
Skill name Lowercase letters, numbers and hyphens; up to 64 characters
Setting Range Default
Temperature 0.0 to 2.0 0.7
Max output tokens 1 up to the chosen model’s maximum 1,000

The maximum output length depends on the model. For example, it is 65,536 tokens for current Gemini models, 128,000 for OpenAI GPT models and most Claude models, and 64,000 for Claude Haiku 4.5. The agent form caps the field at the selected model’s maximum.

When an answer reaches the max output tokens, web chat marks it as cut off and offers Continue.

Item Limit
Attachments per message 3 files
Size per attachment 10 MB
Attachment types Images (JPEG, PNG, GIF, WebP), PDF, plain text, CSV, Markdown, Word (.docx), Excel (.xlsx), PowerPoint (.pptx)
Voice message size 5 MB
Voice message formats WebM, OGG, MP4, MP3, WAV
History shown in the chat panel The latest 10 messages from the user in each conversation, with their replies

The chat panel’s history limit doesn’t affect the audit record: the full transcript stays in Conversations for the retention period.

Whether the model can read images and documents depends on the model. VirtuAI shows a clear error when a model doesn’t support an attachment.

Item Range Default
Supported file types PDF, Word (.docx), Excel (.xlsx, .xls), CSV, PowerPoint (.pptx)
Chunk size 500 to 8,000 characters 2,000
Chunk overlap 0 to 2,000 characters 200
Results per query 1 to 20 5
Score threshold 0.0 to 1.0 0.0 (no filter)
Search type Similarity or MMR (diverse) Similarity
MMR fetch K 5 to 100 20
MMR diversity (λ) 0.0 to 1.0 0.5

Files of other types are skipped on upload. Changing chunk settings applies to documents uploaded or reprocessed afterwards.

Item Range Default
Custom tool timeout 1 to 300 seconds 30 seconds
Custom tool retries 0
Approval prompt Denied if unanswered after 5 minutes
Item Limit
WhatsApp reply length Replies longer than 1,600 characters are sent as several messages
WhatsApp content Text only; a message with only media gets a text reply saying so
Item Range Default
Transcript retention (conversations.retention_days) 1 to 3,650 days 365 days
Export formats CSV for a list; Markdown or JSON for one conversation
Item Limit
Invitation validity 48 hours
Password length At least 8 characters
Budget periods Daily or monthly
Budget actions Warn, or block new requests