enes (ekkovoice)
02/16/2026, 10:50 AMAI Evy
02/16/2026, 10:50 AMAI Evy
02/16/2026, 10:51 AM.md (Markdown) files over .txt — well-structured Markdown is chunked and retrieved more accurately [(1) ]()
- Use clear, descriptive headings and keep each section focused and reasonably short
- Write short paragraphs and lists to separate concepts; avoid walls of text
- Group related information within the same section so chunks remain cohesive and relevant
## Writing Style
- Use specificity in references — include names, dates, units, and avoid ambiguous pronouns like "it" or "this" because prior chunks may not be present
- Use the knowledge base to supply supporting information, not agent instructions or prompts — put instructions in the agent's prompt instead
## Configuration Settings
After connecting a knowledge base to your agent, configure retrieval settings :
- **Chunks to retrieve**: Max number of chunks (1-10) . Default: 3
- **Similarity Threshold**: Higher = fewer but more similar matches. Default: 0.6
For most cases, 3 chunks and a 0.60 similarity threshold are recommended
## Node-Level Knowledge Base
For Conversation Flow agents specifically, you can configure knowledge base at the Conversation Node level — this combines with the agent's global knowledge base to provide more accurate context for specific topics
## Preventing Unwanted Behavior
If your agent is pulling from the knowledge base too often and overriding your conversation flow, add this to your general prompt to restrict usage [(2) ]() :
> "Only answer using the information in ## Related Knowledge Base Contexts. If ## Related Knowledge Base Contexts is missing or does not contain relevant iAI Evy
02/16/2026, 10:51 AMAI Evy
02/16/2026, 10:51 AMenes (ekkovoice)
02/16/2026, 11:08 AMAI Evy
02/16/2026, 11:08 AMAI Evy
02/16/2026, 11:08 AMAI Evy
02/16/2026, 11:08 AM.md file or multiple .md files is better. [(1) ]()
However, based on the best practices provided, splitting into multiple knowledge bases is the recommended approach:
- "Group related information within the same section so chunks remain cohesive and relevant"
- You can create multiple knowledge bases to overcome limits, and an agent can have more than one knowledge base linked to it
A community member who works extensively with knowledge bases shared their approach: "I always split my knowledge base and I always use markdown... I break down everything as much as possible so that it's easier for the knowledge to be retrieved" [(2) ]()
Their example shows breaking content into separate knowledge base files by topic (e.g., "insurance information", "services offered", "salon info", "policies") rather than one large file.
**Recommendation**: Split your content into multiple focused .md files organized by topic/category. This helps ensure:
- Each chunk stays cohesive and contextually relevant
- Retrieval is more accurate for specific queries
- You stay within file limits (max 25 files per knowledge base, 50MB each) [(1) ]()AI Evy
02/16/2026, 11:08 AMenes (ekkovoice)
02/16/2026, 11:18 AMAI Evy
02/16/2026, 11:18 AMAI Evy
02/16/2026, 11:18 AMmulti option to allow the agent to understand both.
- You need to write something like "respond in Spanish" in your prompt for the agent to respond in a specific language.
For the knowledge base, retrieval uses semantic search based on the transcript so far. [(2) ]()
Since the documentation doesn't specify best practices for multilingual knowledge bases, I'd suggest:
Check out these potentially useful sources:
- [Knowledge Base]()
- [Step 1: Configure global settings]()
Would you like me to try to answer generally based on my knowledge instead?AI Evy
02/16/2026, 11:18 AMAI Evy
02/16/2026, 11:18 AMenes (ekkovoice)
02/16/2026, 11:20 AMAI Evy
02/16/2026, 11:20 AMAI Evy
02/16/2026, 11:20 AM.md files or knowledge bases per language
- Keep the structure/topics parallel between languages
- This way, when a user speaks Dutch, the semantic search is more likely to pull Dutch chunks
Since the knowledge base retrieval happens automatically based on the transcript , having content in the user's language should improve retrieval relevance.
Keep in mind this is general guidance — the official documentation doesn't explicitly cover multilingual knowledge base strategies.AI Evy
02/16/2026, 11:20 AMAI Evy
02/16/2026, 11:20 AMenes (ekkovoice)
02/16/2026, 11:38 AMAI Evy
02/16/2026, 11:38 AMAI Evy
02/16/2026, 11:38 AMAI Evy
02/16/2026, 11:38 AM.md files in 1 knowledge base works well when content is related and you want unified retrieval across all of it
- *Separate knowledge bases (2-3 connected to agent) * is useful when:
- You want to assign specific knowledge bases to specific conversation nodes (node-level KB)
- You have distinct topic areas that shouldn't cross-contaminate retrieval
- You're approaching file limits (max 25 files per KB)
For your multilingual use case (English + Dutch) , separate knowledge bases by language could make sense — then you could potentially assign language-specific KBs at the node level if your flow has language-specific paths.AI Evy
02/16/2026, 11:38 AMenes (ekkovoice)
02/16/2026, 12:18 PMAI Evy
02/16/2026, 12:18 PMAI Evy
02/16/2026, 12:19 PMAI Evy
02/16/2026, 12:19 PMOnly answer using the information in ## Related Knowledge Base Contexts.
If ## Related Knowledge Base Contexts is missing or does not contain relevant information, respond:
"There is no related information in knowledge base."
This prevents the agent from generating information not found in the knowledge base.
## Key Points
- Retrieved knowledge base content is automatically appended to the LLM prompt under the header ## Related Knowledge Base Contexts
- The knowledge base supplies supporting information — put instructions and persona in your prompt, not the knowledge base
- Global settings also include voice, language, LLM model selection, and speech settings that complement your global prompt [(1) ]()AI Evy
02/16/2026, 12:19 PMenes (ekkovoice)
02/16/2026, 12:21 PMAI Evy
02/16/2026, 12:21 PMAI Evy
02/16/2026, 12:22 PM## Identity
You are a friendly AI assistant for [Company Name].
Your role is to [specific purpose].
You have expertise in [relevant domains].
## Style Guardrails
Be concise: Keep responses under 2 sentences unless explaining complex topics.
Be conversational: Use natural language, contractions, and acknowledge what the caller says.
Be empathetic: Show understanding for the caller's situation.
## Response Guidelines
Return dates in spoken form: Say "January fifteenth" not "1/15".
Ask one question at a time: Avoid overwhelming the caller with multiple questions.
Confirm understanding: Paraphrase important information back to the caller.
## Task Instructions
[Specific steps the agent should follow]
## Objection Handling
If the caller says they're not interested: "I understand. Is there anything specific..."
If the caller is frustrated: "I hear your frustration, let me help resolve this..."
## What Goes Where
- **Global prompt**: Your agent's overall personality, tone, and universal rules
[(2) ]()
- **Conversation flow nodes**: Step-by-step logic, questions, and transitions
- **Global nodes**: Only for actions available anytime (e.g., "transfer to human")
## Tool/Function Calling with Make.com
Since you're using Make.com automations, define explicit triggers for when tools should be called:
[(1) ]()AI Evy
02/16/2026, 12:22 PM## Tool Usage Instructions
1. Gather initial information about the customer's issue.
2. Determine the type of request:
- If customer mentions "refund" or "money back":
→ Call function `transfer_to_support` immediately
- If customer needs order status:
→ Call function `check_order_status` with order_id
Key practices for tool instructions:
- Use trigger words: List specific words/phrases that should trigger tool calls
- Define sequences: Specify when tools should be called in order
- Set boundaries: Clarify when NOT to call certain tools
## Additional Tips
- Write node instructions concisely so the LLM can better focus on each task
[(3) ]()
- If using Flex Mode with more than 20 nodes, performance may degrade and hallucination risk increases — split into smaller componentsAI Evy
02/16/2026, 12:22 PMAI Evy
02/16/2026, 12:22 PMenes (ekkovoice)
02/16/2026, 12:26 PMAI Evy
02/16/2026, 12:26 PMAI Evy
02/16/2026, 12:26 PMAI Evy
02/16/2026, 12:26 PMAI Evy
02/16/2026, 12:26 PMenes (ekkovoice)
02/16/2026, 12:28 PMAI Evy
02/16/2026, 12:28 PMAI Evy
02/16/2026, 12:28 PMstring | null value with no explicit length constraint mentioned in the API. [(2) ]()
Practical guidance based on documented principles:
- Conversation Flow is designed to "replace prompt engineering with an intuitive, graphical input system" — so much of what would traditionally go in a long prompt should instead be handled through nodes. [(1) ]()
- The global prompt should contain "overall personality, tone, and universal rules" while nodes handle "step-by-step logic, questions, and transitions." [(3) ]()
- Write instructions "concisely so the LLM can better focus on each task." [(4) ]()
Since there's no explicit character/word limit documented for Conversation Flow global prompts, the key is quality over quantity — keep it focused on universal elements (identity, tone, guardrails) and let your nodes handle the task-specific logic.
Would you like a general answer based on my knowledge about typical prompt length best practices?AI Evy
02/16/2026, 12:28 PMAI Evy
02/16/2026, 12:28 PMenes (ekkovoice)
02/17/2026, 1:41 PMAI Evy
02/17/2026, 1:41 PMAI Evy
02/17/2026, 1:41 PMuser_dtmf_options in the agent's Call Settings:
- Digit Limit (user_dtmf_options.digit_limit) : Set to 6 — input completes once 6 digits are entered
- Termination Key (user_dtmf_options.termination_key) : Set to # — allows caller to press pound to finish early
- Timeout (user_dtmf_options.timeout_ms) : Time in milliseconds to wait after the last digit before timing out; the timer resets with each new digit
## Capturing the Input as a Variable
DTMF input is captured automatically and added to the call transcript.
To store it in {{verification_code}}, use an Extract Dynamic Variable node after the caller enters digits.
[(2) ]()
This node lets you capture the DTMF input (e.g., an account number or verification code) and save it for reuse anywhere in the conversation using {{variable_name}}.
## Transitioning to the Next Node
Use a Logic Split Node to check whether {{verification_code}} has the expected value before transitioning to your next Function Node.
The Logic Split Node evaluates conditions immediately when the agent enters it and branches to the corresponding destination.
## Additional Considerations
- Prompt the agent to ask for the code via keypad. Example prompt:
[(1) ]()
Please enter your 6-digit verification code using the keypad. You can finish by pressing the pound key.AI Evy
02/17/2026, 1:41 PMAI Evy
02/17/2026, 1:41 PM