How language works in Fini
The three layers apply in order, from the moment content is ingested to the moment a reply is written:
A folder with no Attribute filter is available to every conversation the agent handles. The reply language itself comes from the rules in your prompts, covered in Control the reply language.
Set the language of your knowledge
Every time you ingest a new source in Sources, two training preferences control how Fini processes it:- Language: the language of your knowledge base. Defaults to English. If your sources are in more than one language, choose Auto-detect so Fini detects each document’s language, or pick a specific non-English language.
- English-only mode: a faster path for English-only knowledge bases that skips per-document language detection.
Organize Articles by language
Articles is the source of truth the agent retrieves from, and its folder tree is where you organize language. A common pattern is one top-level folder per language:Scope language per agent or per conversation
You have two ways to control which language content an agent uses.Per agent
Use the top-right selector in Articles to assign folders to agents. A German-speaking agent can be scoped to German-language folders only, while a support agent for another market draws on a different set. See Assigning knowledge to agents.If two agents need different knowledge bases, scope at the Articles layer. Don’t duplicate Sources or split workspaces.
Per conversation
Folders can carry an Attribute Filter Builder that gates retrieval on conversation context. To serve one language folder only to conversations in that language, add a filter such as: “Only surfaceSpanish / * when System Attribute → conversation language = Spanish.”
Filters on the same attribute combine as OR (Spanish or Portuguese); filters on different attributes combine as AND. A filter on a missing attribute silently excludes the conversation, so check that the attribute is populated if the agent stops answering for a segment of customers. See Attribute filters.
Control the reply language
Reply language rules live in the agent’s Prompts:- Main Guidelines → Role & Context holds the agent’s fundamental interaction rules, including language rules. This is where you state which languages the agent supports and what it should do when a customer writes in a language you don’t serve (for example, reply in English and offer a handoff).
- Channel Prompts let you express a language rule differently per surface. A common example is mirroring the customer’s language on Email, where long, global threads often mix languages, without repeating the rule on Chat.
Language on each surface
Test and debug multilingual agents
- Test in each language. Build a Test Suite set per language, with scenarios written in that language, so a prompt or knowledge change that breaks one language shows up as a pass-rate drop.
- Search Inbox in the customer’s language. The Question and Answer filters in Inbox match literal text. To find a Spanish conversation, search in Spanish, or filter by Tags, Source or Feedback instead.
- Check the retrieved articles. In Inbox, the article titles pinned under a reply show whether the agent used the right language folder. Used Folders in the conversation metadata shows the same at the conversation level.
- Ask Fini Scout. Fini Scout can read a conversation’s prompt, knowledge and trace to explain why a bot mixed languages.
Troubleshooting
The agent replies in the wrong language
The agent replies in the wrong language
Check the language rules in Role & Context and any Channel Prompt for the conversation’s channel. Then open AI Steps and look at Generate Answer to see the agent’s answering strategy for that turn.
The agent doesn't use my non-English articles
The agent doesn't use my non-English articles
Check the language preference on both the source and the agent. An agent set to English-only won’t reliably retrieve from non-English-derived Articles. Also confirm the language folder is assigned to the agent in Articles and that no Attribute filter is excluding the conversation.
Articles in two languages give different answers
Articles in two languages give different answers
Translated articles are separate articles, so an update to one doesn’t change the other. Update both, or retranslate from the canonical version, and approve the changes in Review.
Related
Sources
Training preferences for language at ingestion.
Articles
Language folders, Translate, and Attribute filters.
Prompts
Language rules in Main Guidelines and Channel Prompts.
What is Fini
Channels, surfaces and headline facts.

