Home Getting Started on the Platform
🛫

Getting Started on the Platform

How to set up ClaudIA to test it
Manuela Farias
By Manuela Farias and 7 others
12 articles

How to create ClaudIA's initial content (guide to uploading your first base)

When to use - You are building the first content base for ClaudIA in your project - You need a spreadsheet template and best practices to avoid common mistakes - You want to understand the relationship between IDS, tags, and content types (N1/N2/Interactive) Prerequisites - Access to the project's Hub - Access to the helpdesk to extract tickets (if applicable) - (Optional) FAQs, training materials, and internal documentation to feed the base About this article This guide explains how ClaudIA uses content, how the Cloud Humans team builds the initial base, and the best practices for creating content that minimizes errors and improves retention. What is ClaudIA? ClaudIA is Cloud Humans' generative AI customer service agent. It was created to answer questions with more agility and empathy, using a content base from your company. It is powered by large language models (LLMs) and trained with content extracted from tickets, FAQs, and your team's documents. How does ClaudIA answer requests? ClaudIA works with question/title and answer pairs — what we call IDS (Semantic Data Intelligence). 1. The customer sends a request 2. ClaudIA performs a semantic search in the IDS base 3. It identifies the most relevant content and responds Response flow Structure of each IDS - Question/title — how the customer triggers that content - Answer — text sent when the question is asked - Content type: - N1 — ClaudIA answers on its own - N2 — forwarded to a human - Interactive — triggers a Controlled Flow (spreadsheet, API) - Tag — categorizes the conversation What is a TAG? Each IDS receives a tag. The Tagger is the mechanism that defines the ticket's final tag. How the Tagger decides 1. It looks at which IDS contents were used in the conversation 2. It applies the corresponding tag: - If N2 → tag of the section that was handed over - If Interactive → tag of the section that triggered the Controlled Flow - If N1 → tag of the most relevant content :::info If the conversation used more than one type of content, the priority order N2 → Interactive → N1 applies. Example: a ticket that used an N2 section receives that section's tag, even if an N1 content was more relevant in the conversation. ::: 3. If no content is used, the result depends on the project's default tag setting: - Default tag enabled → the configured default tag (usually NO_TAG) is applied directly - Default tag disabled → ClaudIA analyzes the conversation and tries to apply the tag of the most similar category in your base; the default tag (NO_TAG) is only used if nothing is found Learn more in How to reduce NO_TAG and increase how much ClaudIA classifies 4. The tag is used to generate reports and metrics :::warning We recommend writing tags in lowercase, without accents, without "ç", and separated by underscores (e.g., certificado_incompleto) — this avoids mismatches with your helpdesk and makes reporting easier. ::: How we build the content base Step 1 — Extraction We extract tickets from your helpdesk (~25% of the average volume). Step 2 — Cleaning We remove duplicates. Step 3 — Clustering We group similar questions to avoid duplicates and identify the most common questions. Step 4 — Building the answers Based on: 1. Real answers from agents in the tickets 2. Extra content provided (FAQs, training materials) Step 5 — Spreadsheet generation We generate a Google Sheets file with suggested questions and answers. Step 6 — Client validation You review: - Is the question clear and specific? - Is the answer correct and up to date? - Is the content useful or irrelevant? - What is the correct tag? - Is it N1 or N2? Best practices for creating/validating content :::success - Avoid questions that are too broad. ❌ "Can I change my order?" ✅ "Can I change my purchase order after it has been issued?" - Do not use greetings in the answers — ClaudIA already does this automatically - Avoid duplicated sections — it confuses the model and hurts performance - Use clear, well-written questions/titles — fix spelling mistakes - Point long instructions to external links: "You can renew your certificate by following the step-by-step guide at the link below: [link]." - Include specific instructions inside the IDS title: [If you decide to use the answer below, always send it in full without changing absolutely anything] How do I request a refund? - Add variations of the question in the same section: "I don't have my ID with me right now, can I still attend? / I won't have my ID on the day, is it okay to go anyway? / If I don't have my ID, am I still allowed in?" ::: Template for creation/validation 🔗 Content Validation Template Notes - For detailed best practices: Best practices for creating and maintaining content - To use the content screen: How to use the content screen (single and bulk) - To understand tags: How the Tags system (Tagger) works - For the full category: Content | Managing ClaudIA's knowledge

Last updated on Jul 05, 2026

Roadmap and Feature Request

This will be the official tool where you can: - See what has already been delivered, what we are building, and what is under review - Suggest new features (Feature Request) - Vote on other suggestions 🔗 Access it here: https://cloudhumans.canny.io/ 🎥 And watch this video explaining how it works: https://www.loom.com/share/026bef6e168143fca2ec464a2923e44c We launched this space to provide more transparency about what we are building and to create a direct channel to hear what is most important to you. 💬 Suggestions and votes will be considered in the construction of the Roadmap in the next quarter—so feel free to contribute! 📌 The page will be updated frequently, so it’s worth saving it to your favorites. ❓ If you have any questions, just reach out to us here. Other Questions: Do I need to create an account to use it? Yes, to vote and create suggestions you need to log in. We recommend using your corporate email, as this allows us to send you updates via email when the features you voted on change status or are completed. What can I see on the platform? You can track the roadmap for both Cloud and CloudShare. You can filter to view only one of the products if you prefer. The features are organized by status: what has already been delivered, what is being developed, and what is under review. How does the voting system work? You can vote on the features you find most relevant by clicking the vote button. Although this doesn’t directly change our priority order, it serves as an important insight for us to make future decisions and understand what is most important to the majority of our clients. How to suggest a new feature? You can create a new post describing your suggestion. You can choose a category (we are still defining these categories better) and detail your idea. When you create a post, it automatically comes with your vote. Are the suggestions really considered? Yes! Suggestions and votes will be considered in the construction of the roadmap for the next quarter. This space was created precisely to provide more transparency about what we are building and to create a direct channel to hear what is most important to you. How frequently is the platform updated? The page will be updated frequently, so it’s worth saving it to your favorites to keep up with the news regularly. Will I receive notifications about the features I voted on? Yes, if you use your corporate email during registration, we can send you email updates when the features you voted on change status or move on to other stages. I have questions about how to use the platform. What should I do? If you have any questions, feel free to contact us directly. We are here to help and ensure that you can make the most of this feedback tool. What is the goal of this initiative? We want to create more transparency about what we are building and establish a direct channel to hear what is most important to you. This helps us prioritize developments that truly add value to our clients.

Last updated on Aug 12, 2025

Setting Up the Context, Identity, and Tone of Voice Fields for ClaudIA

Objective Enable each client to clearly define: - The company context that ClaudIA represents in customer service (details about "what" she is helping with). - The identity of the AI ("who" she is). - And the tone of voice used in responses ("how"). This ensures that ClaudIA communicates with greater consistency, correctly representing the brand and adapting her language as expected. What changed and why does it matter? Previously, ClaudIA's tone of voice and brand description could only be configured during onboarding or by manually requesting the Cloud Humans team. Now, with this new functionality, any client can edit these definitions directly in the Hub at any time. Why is this important? - Prevents dependency on support for simple adjustments. - Ensures that new campaigns, branding changes, or repositioning are quickly reflected in the AI. - Allows testing different tones of voice and uses of emojis that can impact the customer's connection to the brand. - More personalization in responses. - Alignment of the AI with the brand voice. - Improvement in the final customer experience. What was launched Two new editable fields in the Hub: 1. Company and Agent Context Where you can fill in the company name, business context, and description of the AI's identity. 2. Voice, Tone, and Style Allows configuration of: - The style of language and formality. - Preferred and avoided expressions. - Emojis that should (or should not) be used. - Any other nuance related to the tone of voice. Where to configure These fields are available in: Hub → Settings → Base Prompt Modules Examples of filling in Company and Agent Context Example 1 (B2B SaaS): We are Cloud X, a marketing automation platform for small and medium-sized e-commerce businesses. Your name is ClaudIA, and you are our virtual assistant, responsible for helping our clients understand features, solve simple technical problems, and forward more complex cases. You are objective, polite, and demonstrate technical expertise. Example 2 (B2C): Your name is ClaudIA, and you represent FitMama, a workout app for pregnant women. She speaks like a welcoming, experienced, and fun coach. The service should be light, with empathy and clear guidance, even for those who don't understand technology. Example 3 (ClaudIA from Cloud Humans): You are acting as ClaudIA, a conversational AI from Cloud Humans. Cloud Humans is a company specialized in CX/support that offers solutions for customer service through a conversational AI and back-office automations, as well as providing its own Helpdesk, CloudChat. The main products of Cloud Humans are ClaudIA (AI) and Cloud Chat (Omnichannel Helpdesk deeply connected with ClaudIA). 🗣 Voice, Tone, and Style Example 1 (More technical and formal style): You should use clear, technical language without emojis. Avoid informal expressions. We prefer short sentences and objective instructions. Example 2 (Warm and human style): Use welcoming language, without very technical terms. You can use emojis like 💡, 😊, and ✅. Avoid “Dear” and “Best regards” — prefer “Hi!”, “I look forward to hearing from you” or “You can count on me!”. Example 3 (ClaudIA from Cloud Humans): You should respond in a tone that is always friendly yet professional, avoiding jargon or slang. Be very empathetic and make Cloud Humans' products appealing. When writing your responses, avoid forming large blocks of continuous text. Whenever there is a change of topic, conclusion of an idea, or new information, separate paragraphs with a line break (a blank line between sentences). Never concatenate multiple sentences into a single long paragraph. Use few emojis, but when deemed appropriate, use only some of these: 🙂🧡🤖👍 Limits and Best Practices Character Limit - We recommend a maximum of 1,000 characters per field to ensure that the AI's base prompt remains agile and efficient. - Very long texts may cause unnecessary semantic dilutions and affect the consistency of the responses. ✅ What to include - The company name, the sector it operates in, and a brief description of it. - The role of the AI (e.g., attendant, assistant, specialist). - The ideal communication style (e.g., empathetic, technical, playful). - Words, emojis, or expressions that should or should not be used. 🚫 What to avoid - Vague texts (e.g., “speak beautifully and kindly”). - Contradictory instructions (e.g., “be formal and super casual at the same time”). - Defining multiple personas in a single context. Strategic Usage Tips - Adapt to the main channel: If your company uses WhatsApp as the main channel, opt for clearer and more concise tones of voice. - Use to strengthen your brand: ClaudIA is part of the customer experience. An aligned tone of voice generates more trust and identification. - Change when necessary: Launching a new product? Black Friday campaign? Temporarily update ClaudIA's tone to reflect this moment. - Write in the primary language of service: even though ClaudIA has features that allow her to respond in multiple languages, instructions in the most common service language will make responses and adherence to instructions even more effective.

Last updated on Aug 12, 2025

Main Screens of ClaudIA Hub: Playground, Content, Dashboard, Tags, Test Cases, Settings, and Integration Configuration

Playground The Playground is a very useful tool that allows us to test the knowledge base and subsequently audit the ticket generated from that test. With the Playground, we can explore various question-and-answer options, verifying the accuracy of our knowledge base and the adequacy of the provided answers. This allows us to make necessary adjustments to ensure the precision and effectiveness of responses to customers. By using the Playground, we can simulate any question directed to ClaudIA. When she responds, we have access to the information used to formulate that response. This allows us to audit the service, if we deem it necessary. To perform an effective audit, we return to the conversations and remove the filter "indicator: client." This helps us obtain a clearer and more accurate view of the interactions. Content The content screen displays all sections of IDS (Improved Data Set) Some things you can do in Content: - Search and filter by sections - View the modification history of a section - Create a new section - Edit an existing section - Temporarily disable a section - Delete a section from the IDS Dashboard Analytical views of ClaudIA and its results Tag Maintenance This is the screen where we register the tag options that each content can have. This allows us to organize and categorize content efficiently, facilitating access and utilization of information. How to create a new tag to use in your content and enable ClaudIA to use it To create a new tag, simply click the "+ create tag" button at the top right of the screen. This will open a new screen where you can create the tag. If the tag you create does not exist in your helpdesk, it will create a tag with that name directly in your helpdesk as soon as you click the save button dynamically and automatically. 🚨The only exception is for Intercom. In Intercom, we are not able to automatically create tags due to the APIs available to us, by the Intercom platform itself. How tags work for those using Intercom If you use Intercom, you will see that there is a different column called "Helpdesk Tag." This is a mapping of tags between ClaudIA and Intercom. If it does not exist in Intercom, an alert will appear in red saying "Missing." Additionally, when you create a new tag by clicking the create tag button, two fields will appear for you to fill out: the tag field, which is the name of the tag you want to use, and the helpdesk tag field, which is the tag from the helpdesk you want to use. This second field is optional, meaning if there is no existing tag in Intercom, you can leave this field blank, but you will need to go to Intercom and create that tag there. If you do not do this, it will continue to show the "Missing" alert and ClaudIA will not be able to use that tag in Intercom. In other words, the tag will only appear in the Hub. How to edit or delete existing tags If you want to edit a tag, just click the pencil (✏️) button to the right of the tag, under the "Action" column. This will open a pop-up similar to the creation one, where you can change the name of the tag. For Intercom users, you can also change the helpdesk tag it is mapped to, switching to another tag. If you want to delete a session, just click the red trash can icon (🗑️) to the right of the session you want to delete, under the column called "Action." It will open a pop-up asking you to confirm that you really want to delete it. If you want to delete, just click the red "Delete" button; if you want to cancel, just click "Cancel." Test Cases This is a more advanced screen, and detailed documentation can be found here. Settings The ClaudIA general settings screen opens as a hub: one card per section (General, Behavior, Handover, Lifecycle, Media and Tags), with global search for any setting and per-block saving. Click a card to open the section's focused editor. ClaudIA Settings hub Integration Configuration (with Helpdesks) This screen is only available to users with privileged access to the Hub (CX Heads, Company Tech Team, etc.). Here you can configure the integration in third-party helpdesks completely self-service without the need for assistance from Clouders.

Last updated on Jun 30, 2026

Conhecendo a ClaudIA e o processo de auditorias

1) Como funciona a ClaudIA ClaudIA é a IA generativa da Cloud Humans, projetada para oferecer atendimento mais humanizado e ágil; Utiliza Modelos de Linguagem de Grande Escala (LLMs), treinados com milhões de textos da internet, livros e artigos; Seu uso é personalizado e restrito à empresa específica que está atendendo; Tem liberdade para adaptar conteúdos, desde que respeite o tom de voz e as políticas da empresa; Ao receber uma solicitação, ClaudIA analisa a dúvida do cliente e consulta sua base de dados, chamada IDS; Realiza uma análise semântica e ranqueia os melhores conteúdos para usar no atendimento. ****Para verificar a base de conteúdo que a IA está utilizando é necessário acessar o Hub da Cloud Humans através desse link aqui (caso ainda não possua acesso basta sinalizar no canal principal do projeto). Após acessar, clique em Conteúdos no menu lateral, como indicado na imagem abaixo: Dessa forma a tela de conteúdos será aberta e será possível realizar tanto a busca exata da informação como a busca semântica - simulando a forma como o cliente pode trazer sua dúvida. Os conteúdos com maior probabilidade de uma resposta correta retornarão no topo. Para testar um atendimento do início ao fim é possível utilizar a opção Playground, também disponível no Hub pelo menu lateral. 2) Erros da ClaudIA durante os atendimentos É importante destacar que por mais completo seja o conteúdo disponível para a IA realizar os atendimentos, ela sempre terá uma % de erro associada ao seu desempenho. Isso acontece por vários motivos, dentre eles: - Pergunta ambígua do usuário: muitas vezes o cliente pode trazer sua dúvida de forma não muito clara, fazendo com que a ClaudIA utilize um conteúdo incorreto ou escale por falta de informações; - Conteúdo desatualizado: aqui se aplicam casos de mudanças na política interna, links ou processos da empresa sem atualizar o conteúdo no Hub; - Falta de conteúdo: lançamentos de novos produtos, promoções e até bugs ou lentidão devem ser inseridos como conteúdo para a ClaudIA ter acesso à nova informação; - Falta de compreensão real: por mais humanizada que a ClaudIA seja, seu funcionamento é feito a partir da identificação de padrões estatísticos entre palavras e ideias, o que pode estar sujeito à erros Aqui na Cloud Humans consideramos que a ClaudIA pode ter 3 tipos de erros, que podem ser classificados durante o processo de auditoria: - Erros do tipo 1 (leves): informação correta, mas faltou algum detalhe que deixaria a experiência mais completa; - Erros do tipo 2 (moderados): informação parcialmente correta, ClaudIA omitiu ou incluiu algum conteúdo sem necessidade; - Erros do tipo 3 (graves): informação totalmente incorreta, casos n2 que ClaudIA não transferiu, etc; O que observamos na média de projetos com boa gestão da IA é que a taxa de erros gerais (somando os 3) não passa de 20%, sendo no máximo 5% de erros do tipo 3. Esse pode ser um bom parâmetro para quem está iniciando o processo de auditorias e precisa de uma meta inicial. Com relação à quantidade de tickets que precisam ser auditados isso vai depender da volumetria do projeto em questão: Aqui trazemos uma sugestão pensando no mês, considerando um grau de confiança de 99% e uma taxa de erro de 5%: - De 20k à 40k tickets no mês: 1000 auditorias mensais; - De 10k à 20k tickets no mês: 800 auditorias mensais; - De 5k à 10k tickets no mês: 600 auditorias mensais; - Até 5k tickets no mês: 400 auditorias mensais; 3) Iniciando as auditorias Uma parte essencial da melhoria contínua da ClaudIA é feita através das auditorias dos tickets respondidos. Essa etapa é fundamental para identificar a falta de conteúdo na base e corrigir possíveis respostas e/ou transferências incorretas durante o atendimento. Para isso acesse nosso Hub através desse link aqui (caso ainda não possua acesso basta sinalizar no canal principal do projeto). Obs: Caso esteja na etapa de auditoria de tickets falsos, não esqueça de retirar o filtro Identificador: Cliente, indicado na imagem abaixo: Os tickets fechados mais recentemente estão no topo. Recomendamos sempre iniciar as auditorias por eles, dado que trazem uma visão mais atual da qualidade do atendimento da ClaudIA. Filtros também podem ser adicionados para para auditar uma amostra específica (ex: por tag), porém, caso esteja iniciando seu processo de qualidade da ClaudIA, recomendamos evitar essa segmentação e auditar tickets de forma aleatória, contemplando tanto casos n1, como n2. Para iniciar a auditoria basta clicar no ícone da coluna Ação, como ilustrado na imagem abaixo: Ao abrir o ticket você encontrará algumas informações, como: - Projeto: nome do projeto, caso sua empresa tenha mais de uma ClaudIA, a sinalização é feita aqui; - ID Helpdesk: é o ID do ticket no seu Helpdesk, caso queira verificar o atendimento internamente; - ID Cloudchat: é o ID no ticket dentro do Hub, é o mesmo presente na URL do ticket aberto; - Criado em: Data e hora do início do atendimento; - Resolução: N2 são todos os casos que a ClaudIA finalizou o atendimento transferindo para um humano. N1 são todos os casos que a ClaudIA finalizou o atendimento sozinha. - TAG: tag aplicada pela ClaudIA no final do atendimento. - Número de interações: Soma das mensagens enviadas pelo cliente e pela ClaudIA - Teste A/B: Caso exista um teste de performance acontecendo, ele será apontado aqui. Abaixo dessas informações estarão as interações ocorridas durante o atendimento entre o cliente e a ClaudIA. Para verificar qual o racional utilizado pela IA e a lista de conteúdos que retornaram em sua busca você pode clicar no ícone i ao lado das mensagens: Dessa forma é possível analisar o que levou a ClaudIA a utilizar determinado conteúdo e realizar os ajustes necessários, caso a resposta esteja incorreta ou não seja aplicável para o cenário em questão: Para ajustar a resposta da ClaudIA é necessário clicar na opção de thumbsdown e indicar o problema na resposta (esse dado refletirá em seu dashboard de métricas, também disponível no Hub): Após isso, algum ajuste precisa ser feito para que no próximo atendimento a ClaudIA atenda como esperado. Veja exemplos de possíveis ajustes: - Deveria ter utilizado outra seção para responder: Caso: Pergunta do cliente estava clara e ClaudIA fez uma seleção errada do conteúdo; Correção: Mudança no título para tornar a resposta mais relevante, para isso utilize o lápis ao lado da seção. Após isso indique que aquela seção é a correta e clique em Enviar para salvar seus ajustes e suba a tela para concluir a auditoria. - A resposta estava incompleta: Caso: Claudia omitiu parte do conteúdo da resposta; Correção: Podemos indicar por [] no Título para que ela nunca omita informações nesse conteúdo específico. - Precisava ter clarificado antes de responder: Caso: Pergunta do cliente estava ambígua e ClaudIA não fez uma triagem antes de fornecer a resposta; Correção: Adicionar conteúdo pedindo quais detalhes gostaria que o cliente informasse. - Alucinação: Caso: ClaudIA saiu totalmente do conteúdo, inventou informações, etc; Correção: Reporte no canal oficial da Cloud Humans para apoio na análise. - Deveria escalar por falta de conteúdo: Caso: ClaudIA não tinha informação e reteve o cliente; Correção: Nessa situação o mais indicado é incluir um novo conteúdo n2 para que a transferência ocorra e de forma mais rápida no próximo atendimento. Para isso clique em Nenhuma das opções para criar novo conteúdo. - Problema no conteúdo da IDS: Caso: ClaudIA escolheu conteúdo certo, mas ele estava desatualizado; Correção: Nessa situação o mais indicado é incluir um novo conteúdo n2 para que a transferência ocorra e de forma mais rápida no próximo atendimento. Para isso clique em Nenhuma das opções para criar novo conteúdo. Extra: ClaudIA não ativou o Fluxo Controlado: Caso um fluxo esteja publicado no Fluxo Controlado, mas por algum motivo essa seção não esteja sendo ativada vale conferir o título da seção e adaptar as palavras chaves para o conteúdo ganhar maior relevância e prioridade na escolha da ClaudIA. Caso queira saber mais sobre, recomendamos esse artigo sobre o funcionamento entre ClaudIA e Fluxos Controlados. Obs: caso não tenha certeza de qual ajuste realizar ou seja um caso de alucinação grave, peça apoio por meio do canal oficial do projeto para que um de nossos especialistas ajude nas mudanças necessárias. 4) Motivos de transferência da ClaudIA Existem alguns gatilhos que podem fazer com que a ClaudIA transfira um atendimento. Conhecer cada um deles e entender qual está sendo o mais ofensor na retenção dos tickets ajuda na estratégia para aumento de retenção da IA. O motivo de transferência aparecerá sempre na nota interna, ao final do atendimento, como mostra o exemplo abaixo: Seguem os motivos de transferência da ClaudIA e explicação: - Claudia usou conteúdo N2: dentre os conteúdos que voltaram para a Claudia responder, ela escolheu utilizar um conteúdo N2 para responder o cliente; - Claudia detectou ação de transferência: Cliente foi transferido após Claudia enviar alguma mensagem indicando que iria transferir o atendimento para um agente/suporte; - Cliente Pediu Humano: Cliente insistiu em falar com humano e a Claudia escalou - Claudia pediu detalhes e não entendeu a solicitação do cliente: Claudia fez perguntas de clarificação para o cliente até atingir o limite dessas perguntas - aponta necessidade de ajuste no conteúdo - Claudia não sentiu confiança na resposta: Claudia respondeu sem confiança por 2 ou 3 vezes seguidas - aponta necessidade de ajuste no conteúdo - Claudia não resolveu o problema do cliente: Após Claudia perguntar se pode auxiliar em algo mais, o cliente ainda permaneceu com dúvidas sobre o mesmo problema. - Interação superior ao limite de mensagens: A conversa entre o cliente e a Claudia extrapolou o número máximo de mensagens permitido - Repetição do mesmo Fluxo Controlado: Para garantir que o cliente não fique entrando no mesmo Fluxo Controlado diversas vezes, ele é escalado antes do fluxo ser acionado pela segunda vez - Fluxo Controlado Transferiu: Cliente foi transferido dentro de um Fluxo Controlado - Erro na chamada do Fluxo Controlado: Houve algum erro no Fluxo Controlado durante a conversa - Escalou por receber anexo: Claudia escalou o cliente após ele enviar algum anexo (imagem, pdf) - Escalado de maneira forçada: Agente retirou o ticket da Claudia - Escalou fora do horário de atendimento humano: Claudia escalou porque não havia atendimento humano disponível (Human Office Hours) - Claudia ficou mais de 10 minutos sem responder (timeout): Claudia escalou após demorar mais de 10 minutos para responder à última mensagem do cliente

Last updated on Jun 24, 2026

Error Validation in Controlled Flows

This article discusses the most common types of errors that should be validated before publishing Controlled Flows, as well as how to identify and fix them. Adopting these best practices helps ensure that the flow functions cohesively, all paths are covered, and the end-user experience remains consistent. Automatic Validation in the Editor Controlled Flow validation is performed automatically after each change made in the editor, providing real-time feedback on inconsistencies and points of attention. The validation does not prevent the flow from being published, but it is recommended that all issues be reviewed and resolved before the flow goes into production. Known Errors Missing ClaudIA block in branches Each branch of the flow must have at least one ClaudIA block before the end of the path. ClaudIA needs this information to identify that the flow has ended and to take the necessary actions (continue support, resolve N1, escalate to N2, etc.). Missing text associated with ClaudIA block The ClaudIA block exists but has no associated text. The text block can be positioned before or after the ClaudIA block, provided there is no Input block positioned between them. Incomplete Conditions Alerts when conditional blocks (IF, ELSE) are not properly filled out. It is important that all outputs from the conditional are connected to some block, so the flow can proceed without errors. Broken Links Indicates that a link block points to a flow that no longer exists or has not been published yet. This warning can be ignored during flow creation but must be resolved at the time of publication. Missing text between input blocks Occurs when sequences of text input blocks are connected directly without a message between them. To prevent errors in ClaudIA integration, it is necessary to always send a message before any information collection. Conclusion Ensuring that all Controlled Flows are validated before publishing is essential to provide a smooth user experience, reduce operational errors, and maintain the integrity of Claudia's logic. With the validations and best practices outlined here, your team can build more robust, predictable, and easier-to-maintain flows.

Last updated on Jun 24, 2026

GET STARTED: Initial and Essential Settings for Setting Up Claudia

When to use - You just got access to the Hub and need to set up ClaudIA for the first time - You want a complete checklist of the minimum settings before uploading content - You are setting up the environment for a new ClaudIA project Prerequisites - Administrator access to the ClaudIA project Hub - (Recommended) Having filled out the essential information form about your operation and integration - Knowing the identity ClaudIA will take on (name, context, tone) About this article This is the official step-by-step guide to configure ClaudIA for the first time. Settings were redesigned: the stacked tabs are gone and a Hub took their place — an overview with one card per section that opens a focused editor when clicked. Each block has its own Cancel and Save buttons (only active once you change something in that block), and numeric fields use a stepper (+/−). To understand the navigation, see ClaudIA Settings — the new Hub (overview). Open ClaudIA → Settings. The screen opens on the Hub: ClaudIA Settings Hub Follow the order below. Each step points to the exact section → block → field and links to the detailed article. Step by step — Settings Step 1 — Behavior → Base prompt (identity and tone) Open the Behavior card and go to the Base prompt block (Base prompt modules). Fill in: - Company and ClaudIA context — what the company does and who ClaudIA is (identity) - Voice, tone and style — how she speaks: formality, emojis, preferred/forbidden terms - Project-specific rules — rules and restrictions that apply only to this project :::info Project-specific rule example: If the customer asks questions about brands X, Y, Z, gently redirect the conversation without mentioning those brands, indicating that you do not work with them. ::: Behavior section in the Settings Hub Field details in Context, identity and tone of voice fields and in ClaudIA Settings — Behavior. Step 2 — (Optional) Behavior → Automatic translation If a large share of customers write in another language, enable Automatic translation and choose the Supported languages. ClaudIA detects the language from the first messages and starts replying in it. More details. Step 3 — Lifecycle → Greetings → Initial greeting Open the Lifecycle card, Greeting messages block, and fill in the Initial greeting — the message that replaces {GREETING} in the first interaction. Mention the project/company name. Examples: - "It's a pleasure to receive your message! This is ClaudIA, XPTO's virtual assistant." - "Hi! Great to have you here 😊 I'm Claudia, support team assistant at XPTO." - "Hello! How are you? I'm Claudia, a support consultant here at XPTO." :::success Best practices: - Adapt the tone to the company's profile - Avoid overly formal or robotic language - Use emojis moderately - Personalize with the company name and ClaudIA's role ::: Lifecycle section in the Settings Hub More details in Adjusting the AI name and initial greeting. Step 4 — Transfer → N2 Transfer → Transfer message Open the Transfer card, N2 Transfer block (Main settings), and fill in the Transfer message — sent when the transfer to a human is not content-based (attempt limits, transfer verification, message limits, clarification limits). Transfer section in the Settings Hub Step 5 — Transfer → Automatic transfer → Unanswered ticket escalator In the Unanswered ticket escalator block, fill in the Escalation message — sent when a ticket goes unanswered or an internal error occurs. It can be the same message as Step 4. More details. Step 6 — Transfer → Human availability In the Human availability block, configure the Standard support hours — ClaudIA uses this to tell the customer whether someone is available at the moment of transfer. Personalize the Out-of-hours message and, if you want to close in N1 outside business hours, enable Resolve as N1 out of hours. Also register Special dates and holidays when you need exceptions. Human availability block — Standard support hours More details in How to set up out-of-hours message for N2 (human team unavailable). Step 7 — Lifecycle → Automatic Resolution → Problem resolved checker Validates with the customer whether the issue was resolved before closing. It has two independent modes — you can enable one, the other, or both at the same time: - Scheduled — asks via a timer. Enable Scheduled mode, set the verification Question and the Minutes until the question. Problem resolved checker — Scheduled mode - On message (proactive) — enable Real-time mode so ClaudIA detects, on each message, whether the issue is resolved. Problem resolved checker — On-message (real-time) mode More details in Validate problem resolution before closing (Problem Solved Verifier). Step 8 — Lifecycle → Automatic Resolution → Automatic closing Define when to close tickets without a reply: enable Automatic closing, adjust the Minutes without reply, and write the closing messages with feedback and without feedback. Automatic closing block in ClaudIA Settings More details in How to set up automatic ticket closing in N1 (Ticket Resolver). Step 9 — Other settings Other settings (Classification and intent, Frustration detection, Controlled Flows, Media and Tags) are customized as needed after operations start, to calibrate Retention, Quality and CSAT targets. Step by step — Content 1 — Upload initial content via Sources In the Content section, use Sources to upload initial FAQ content, product lists, or website data. More details 2 — Build content manually - Guide to creating initial content for ClaudIA - Best practices for creating and maintaining content - How to use the content screen (single and bulk) 3 — Support from the Cloud Humans team If you don't want to create content yet, are unsure, or lack a team to start: that's okay! During Onboarding, the Cloud Humans team supports you and can bulk-upload content in this format. Final step — Test in the Playground Open the Playground and send a message to ClaudIA. Done! Initial setup complete. Important points :::warning 1. If you haven't filled out the essential information form about your operation and integration yet, fill it here 2. During Onboarding, we assess additional implementation needs to ensure the expected results ::: Notes - To learn about all the Hub screens: What are the main screens of the ClaudIA Hub - For an explanatory video about ClaudIA and settings: ClaudIA overview and Settings - To create content from scratch: Guide to creating initial content for ClaudIA - For the audit process: How ClaudIA works and the audit process

Last updated on Jul 01, 2026

Message Translation

Overview What is the Message Translation feature? Message Translation allows agents and supervisors to translate any text message directly within CloudChat. The translation appears in a side panel without altering the original message — the customer never sees it, and the chat history remains intact. Who is this feature for? Any agent or user with access to a conversation can use translation. No additional setup is required — the feature is available globally for all CloudChat accounts. How to use How do I access message translation? 1. During a conversation, hover over the message you want to translate. 2. Click the three-dot icon (⋮) at the corner of the message. 3. In the context menu, click "Translate" (indicated by a translation icon). What happens after I click "Translate"? A side panel opens on the right side of the chat. First, it displays the text "Translating..." with a loading indicator. After a few seconds, the panel updates to show: - Original content — the message text as it was sent, with all formatting preserved. - A dividing line. - Translated content — the translated text with formatting preserved. Can I translate messages sent by the agent too? Yes. Translation works for both received messages (from the customer) and sent messages (by the agent or bot). This is especially useful when a supervisor needs to understand responses in a language they don't speak. Can I translate audio, image, or video messages? No. The "Translate" option only appears on text messages. Messages that are only images, audio, video, or files (without accompanying text) do not display the option in the context menu. Language and settings To which language is the message translated? The message is translated into the language set in your CloudChat account. For example, if your account is set to Brazilian Portuguese (pt_BR), all translations will be into pt_BR. If set to English, translations will be into English. Can I manually select the target language? No. The target language is automatically determined by the account settings. There is no manual language selection during translation. Where do I configure my account language? The account language is set in CloudChat's general settings. If you need to change it, access your account settings or contact your organization’s administrator. Behavior and technical details Does translation modify the original message? No. The translation is just a view in the side panel. The original message in the chat remains exactly as it was sent. The customer never sees the translation, and no text is altered in the chat history. Is message formatting preserved in translation? Yes. The translation maintains the original message's formatting — bold, italics, lists, links, and other elements appear in both the original and translated content within the panel. If I translate the same message again, do I need to wait? No. Once a message has been translated, the result is cached. If you click "Translate" again on the same message, the translation appears instantly without loading. What happens if the translation fails? If it fails, the side panel displays the message: "Unable to translate this content". If this occurs, try again in a few seconds. If the problem persists, contact support. What technology is used for translation? The translation is performed using artificial intelligence (OpenAI GPT), not rules or a dictionary. This enables more natural translations with better context understanding. However, as with any automatic translation, very rare inaccuracies may occur — especially with highly regional slang, technical terms, or ambiguous phrases. Recommended use cases I am an agent and received a message in a language I don't understand. What should I do? Hover over the message, click the three dots (⋮), and select "Translate". Within seconds, the side panel will show the translation in your account language. You can continue the conversation normally — the translation is only for your reference. I am a supervisor and want to review conversations in other languages. Use the translation for messages from both the agent and the customer to understand the full chat. Since the feature covers both received and sent messages, you can follow the entire context without knowing the language. I serve clients in multiple languages. Do I need to configure anything? No. Translation works automatically for any source language. Just ensure your account language is correctly set (e.g., pt_BR) — all messages will be translated into that language, regardless of what language the customer used. Additional frequently asked questions Do I need to activate translation in my account? No. The feature is available globally for all accounts. No additional setup is required for each account or agent. Can the customer see that I translated their message? No. The translation is completely invisible to the customer. It only appears in the agent's side panel, without notifications or changes to the chat. Does translation work for bot messages (ClaudIA)? Yes. Messages sent by the bot can also be translated — they are treated as sent messages, just like those from a human agent. Is there a limit to how many times I can translate? No, there is no documented limit per agent or conversation. Use the feature whenever needed. Does translation work offline? No. Since translation is performed via cloud AI, an internet connection is required to use it.

Last updated on Mar 26, 2026

How to Set Up MCP Servers for Your Agents

How to Set Up MCP Servers for Your Agents What are MCP Servers? MCP (Model Context Protocol) servers are services that provide tools for agents to use during conversations. For example, an MCP server can offer tools like "Check Order Status," "Schedule Meeting," or "Search Boleto by CPF". With the new multi-MCP functionality, you can connect your agents to multiple MCP servers simultaneously, combining tools from different sources. Step 1: Access the Settings 1. Log in to the platform 2. Click on your name in the lower left corner 3. Select Settings In the Settings screen, scroll down to the MCP Servers section. You will see the already configured servers. The Controlled Flow server appears by default and cannot be removed. Step 2: Add a New MCP Server 1. Click on the + Add Server button A creation dialog will open: 1. Fill in the fields: - Name: A name to identify the server (e.g., "My Test Server") - URL: The MCP server address (e.g., https://mcp.cloudhumans.com/cloudhumans) - Auth Type: How the agent will authenticate with the server - None: No authentication - Bearer Token: Use an access token - API Key: Use an API key 2. If you choose Bearer Token or API Key, an extra field appears for you to enter the credential: 1. Click Add Server. Done! The server appears in the list along with the default servers. Credentials are encrypted and will never be shown on the screen again. Step 3: Create an Agent with Tools from Your MCP Servers Now that the MCP server is registered, you need to create (or edit) an agent and select which tools it can use — including those from the server you just added. Creating a New Agent 1. Go to Agents in the side menu 2. Expand the react-agent template 3. Click on + New Agent 4. Fill in the agent's name and description 1. Scroll down to the Agent Tools section In this section, you will see all available MCP servers, each as an expandable group: Selecting Tools from Multiple Servers The goal here is to activate tools from all the servers you want to use. In our example, we will activate tools from both Controlled Flow and My Test Server that we just added. - Expand each server by clicking on its name - Use the Select all toggle to activate all tools at once - Or activate individual tools by toggling each one In the image above, both servers have tools activated: Controlled Flow with 4 tools and My Test Server with 3 tools. The badge shows how many tools are selected in each server. By expanding the server you added, you can see the available tools with their descriptions, all activated: 1. Click Create Agent The agent appears in the list with the MCP Tools badge, indicating it has tools configured: Editing an Existing Agent To change the tools of an existing agent: 1. Click Edit on the agent card 2. Scroll down to the Agent Tools section 3. The already selected tools will appear activated 4. Activate or deactivate tools as needed 5. Click Save Changes Step 4: Test the Agent 1. Go to Chat in the side menu 2. Select the agent you configured 3. Start a conversation and ask a question that requires using one of the tools The agent will automatically decide which tool to use based on the conversation. For example, if you ask "What is today's date?", the agent will use the Get Today's Date tool. Editing or Removing a Server Servers you added can be edited or removed: - Click on the three dots menu next to the server - Select Edit to change name, URL, or authentication - Select Delete to remove Note: Servers marked as Default (such as Controlled Flow) cannot be edited or removed. Frequently Asked Questions Can I add as many servers as I want? Yes, there is no limit to MCP servers per tenant. Are my credentials secure? Yes. Credentials are encrypted before being stored. They are only decrypted when the agent needs to connect to the server. Are servers shared among tenants? No. Each tenant has its own MCP servers. Servers added in the "Acme" tenant do not appear in the "Widgets Inc" tenant. The Default servers (Controlled Flow) are the only ones available across all tenants. Do I need to reselect tools when editing an agent? No. Selected tools are saved with the agent. When editing, they will already appear activated. What happens if an MCP server goes offline? The agent continues to work but will not be able to use tools from that server. Tools from other servers remain available as usual.

Last updated on Jun 24, 2026

Getting to know ClaudIA and the audit process

1) How ClaudIA works ClaudIA is Cloud Humans' generative AI, designed to deliver a more humanized and agile customer service; It uses Large Language Models (LLMs), trained on millions of texts from the internet, books, and articles; Its use is personalized and restricted to the specific company it is serving; It has the freedom to adapt content, as long as it respects the company's tone of voice and policies; When it receives a request, ClaudIA analyzes the customer's question and consults its knowledge base, called IDS; It performs a semantic analysis and ranks the best contents to use in the conversation. ****To check the content base the AI is using, you need to access the Cloud Humans Hub through this link here (if you don't have access yet, just let us know in the project's main channel). After logging in, click "Conteúdos" (Contents) in the side menu, as shown in the image below: This will open the contents screen, where you can perform both an exact search for the information and a semantic search — simulating the way the customer might phrase their question. The contents with the highest probability of a correct answer will appear at the top. To test a conversation from start to finish, you can use the Playground option, also available in the Hub through the side menu. 2) ClaudIA's errors during conversations It is important to highlight that no matter how complete the content available for the AI to handle conversations may be, it will always have an error % associated with its performance. This happens for several reasons, including: - Ambiguous user question: the customer may often phrase their question in a way that is not very clear, causing ClaudIA to use an incorrect content or escalate due to lack of information; - Outdated content: this covers cases of changes in the company's internal policy, links, or processes without updating the content in the Hub; - Missing content: new product launches, promotions, and even bugs or slowness must be added as content so ClaudIA has access to the new information; - Lack of real understanding: as humanized as ClaudIA may be, it works by identifying statistical patterns between words and ideas, which can be subject to errors Here at Cloud Humans we consider that ClaudIA can make 3 types of errors, which can be classified during the audit process: - Type 1 errors (minor): correct information, but some detail was missing that would have made the experience more complete; - Type 2 errors (moderate): partially correct information, ClaudIA omitted or included some content unnecessarily; - Type 3 errors (severe): completely incorrect information, N2 cases that ClaudIA did not transfer, etc; What we observe on average in projects with good AI management is that the overall error rate (adding up all 3) does not exceed 20%, with at most 5% of type 3 errors. This can be a good benchmark for those who are starting the audit process and need an initial target. Regarding the number of tickets that need to be audited, it will depend on the volume of the project in question. Here is a monthly suggestion, considering a 99% confidence level and a 5% error rate: - From 20k to 40k tickets per month: 1000 monthly audits; - From 10k to 20k tickets per month: 800 monthly audits; - From 5k to 10k tickets per month: 600 monthly audits; - Up to 5k tickets per month: 400 monthly audits; 3) Starting the audits An essential part of ClaudIA's continuous improvement happens through audits of the answered tickets. This step is fundamental to identify missing content in the base and to correct possible incorrect answers and/or transfers during the conversation. To do this, access our Hub through this link here (if you don't have access yet, just let us know in the project's main channel). Note: If you are at the stage of auditing false tickets, don't forget to remove the "Identificador: Cliente" (Identifier: Customer) filter, shown in the image below: The most recently closed tickets are at the top. We recommend always starting the audits with them, since they provide a more up-to-date view of the quality of ClaudIA's service. Filters can also be added to audit a specific sample (e.g., by tag); however, if you are just starting your ClaudIA quality process, we recommend avoiding this segmentation and auditing tickets randomly, covering both N1 and N2 cases. To start the audit, just click the icon in the "Ação" (Action) column, as illustrated in the image below: When you open the ticket you will find some information, such as: - Projeto (Project): the project name; if your company has more than one ClaudIA, it is indicated here; - ID Helpdesk: the ticket ID in your Helpdesk, in case you want to check the conversation internally; - ID Cloudchat: the ticket ID within the Hub, the same one present in the URL of the open ticket; - Criado em (Created at): date and time when the conversation started; - Resolução (Resolution): N2 covers all cases in which ClaudIA ended the conversation by transferring it to a human. N1 covers all cases in which ClaudIA ended the conversation on its own. - TAG: tag applied by ClaudIA at the end of the conversation. - Número de interações (Number of interactions): sum of the messages sent by the customer and by ClaudIA - Teste A/B (A/B Test): if a performance test is running, it will be indicated here. Below this information you will find the interactions that took place during the conversation between the customer and ClaudIA. To check the rationale used by the AI and the list of contents returned in its search, you can click the i icon next to the messages: This way it is possible to analyze what led ClaudIA to use a certain content and make the necessary adjustments if the answer is incorrect or not applicable to the scenario in question: To adjust ClaudIA's answer, you need to click the thumbsdown option and indicate the problem with the answer (this data will be reflected in your metrics dashboard, also available in the Hub): After that, some adjustment needs to be made so that in the next conversation ClaudIA responds as expected. Here are examples of possible adjustments: - Should have used another section to answer: Case: The customer's question was clear and ClaudIA made a wrong content selection; Fix: Change the title to make the answer more relevant; to do this, use the pencil next to the section. Then indicate that this section is the correct one and click "Enviar" (Send) to save your adjustments, and scroll up to complete the audit. - The answer was incomplete: Case: Claudia omitted part of the answer's content; Fix: We can indicate it with [] in the Title so that it never omits information in that specific content. - Should have clarified before answering: Case: The customer's question was ambiguous and ClaudIA did not do a triage before providing the answer; Fix: Add content asking which details you would like the customer to provide. - Hallucination: Case: ClaudIA went completely outside the content, made up information, etc; Fix: Report it in the official Cloud Humans channel for support with the analysis. - Should have escalated due to missing content: Case: ClaudIA did not have the information and retained the customer; Fix: In this situation, the most appropriate action is to add a new N2 content so that the transfer happens, and faster, in the next conversation. To do this, click "Nenhuma das opções" (None of the options) to create new content. - Problem with the IDS content: Case: ClaudIA chose the right content, but it was outdated; Fix: In this situation, the most appropriate action is to add a new N2 content so that the transfer happens, and faster, in the next conversation. To do this, click "Nenhuma das opções" (None of the options) to create new content. Extra: ClaudIA did not trigger the "Fluxo Controlado" (Controlled Flow): If a flow is published in the Fluxo Controlado but for some reason that section is not being triggered, it is worth checking the section title and adapting the keywords so the content gains more relevance and priority in ClaudIA's selection. If you want to know more, we recommend this article about how ClaudIA and Fluxos Controlados work together. Note: if you are not sure which adjustment to make, or if it is a severe hallucination case, ask for support through the project's official channel so one of our specialists can help with the necessary changes. 4) ClaudIA's transfer reasons There are some triggers that can make ClaudIA transfer a conversation. Knowing each of them and understanding which one is hurting ticket retention the most helps in the strategy to increase the AI's retention. The transfer reason will always appear in the internal note, at the end of the conversation, as shown in the example below: Here are ClaudIA's transfer reasons and their explanations: - "Claudia usou conteúdo N2" (Claudia used N2 content): among the contents returned for Claudia to answer, she chose to use an N2 content to answer the customer; - "Claudia detectou ação de transferência" (Claudia detected a transfer action): the customer was transferred after Claudia sent a message indicating that she would transfer the conversation to an agent/support; - "Cliente Pediu Humano" (Customer Asked for a Human): the customer insisted on speaking with a human and Claudia escalated - "Claudia pediu detalhes e não entendeu a solicitação do cliente" (Claudia asked for details and did not understand the customer's request): Claudia asked the customer clarifying questions until reaching the limit of those questions — indicates a need for content adjustment - "Claudia não sentiu confiança na resposta" (Claudia did not feel confident in the answer): Claudia answered without confidence 2 or 3 times in a row — indicates a need for content adjustment - "Claudia não resolveu o problema do cliente" (Claudia did not solve the customer's problem): after Claudia asked if she could help with anything else, the customer still had questions about the same problem. - "Interação superior ao limite de mensagens" (Interaction above the message limit): the conversation between the customer and Claudia exceeded the maximum number of messages allowed - "Repetição do mesmo Fluxo Controlado" (Repetition of the same Controlled Flow): to ensure the customer does not keep entering the same Controlled Flow several times, they are escalated before the flow is triggered a second time - "Fluxo Controlado Transferiu" (Controlled Flow Transferred): the customer was transferred within a Controlled Flow - "Erro na chamada do Fluxo Controlado" (Error calling the Controlled Flow): there was some error in the Controlled Flow during the conversation - "Escalou por receber anexo" (Escalated after receiving an attachment): Claudia escalated the customer after they sent an attachment (image, pdf) - "Escalado de maneira forçada" (Escalated in a forced way): an agent took the ticket away from Claudia - "Escalou fora do horário de atendimento humano" (Escalated outside human service hours): Claudia escalated because there was no human service available (Human Office Hours) - "Claudia ficou mais de 10 minutos sem responder (timeout)" (Claudia went more than 10 minutes without responding — timeout): Claudia escalated after taking more than 10 minutes to respond to the customer's last message

Last updated on Jul 05, 2026

ClaudIA overview and settings (explainer video + FAQ)

When to use it - You want a quick overview of how ClaudIA works — from the help desk to auditing - You need to explain the tool to someone new on the team - You want a summary of the available settings and operational best practices Prerequisites - Access to the ClaudIA project Hub - An integrated help desk and the operation up and running About this article This article brings an explainer video and the structured FAQ transcript with everything you need to understand about how ClaudIA works: integration, per-message decisions, content, auditing, and settings. :::info ClaudIA's Settings have been redesigned into a Hub (one card per section, opening a focused editor). The video below still shows the old screen in some parts, but the section names and paths mentioned in this text already follow the new Hub. For the current navigation, see ClaudIA Settings — the new Hub. ::: 🎥 Watch the video on Loom Integration and operation What is ClaudIA and how does it integrate with my help desk? ClaudIA connects to your help desk (WhatsApp, chat, etc.). Every customer message enters the help desk, is routed by rules/automation and, when assigned to ClaudIA, the conversation flows through it with full mirroring — you see everything both in the help desk and on the Cloud Humans platform. When is the integration suspended? The integration is paused when: - The conversation is resolved at N1 - ClaudIA closes the ticket directly - There is prolonged inactivity with no new message from the customer - The ticket is transferred to N2 / manually "taken over" in the Hub What should I not do in the help desk? :::warning - Do not remove the ticket from the inbox in the middle of the flow - Do not reply "on the side" without taking over the ticket - Do not "hand back" to ClaudIA after a human has taken over Each help desk has its own particularities — check specific recommendations in the Help desk integrations category. ::: How do I "take over" a ticket manually? In the Hub, view the open tickets and click Take all or Take a specific one. From that point on, the human takes over the flow of that conversation. ClaudIA's per-message decisions How does ClaudIA decide what to do with each message? When it receives a new message, it evaluates: - Attachments (audio/image/document) - The possibility of resolving directly - Signs of frustration - Language Then it searches for content, chooses the necessary agents, and only then replies, transfers, or triggers an interactive flow. How does language detection work? Identification happens at the beginning of the conversation (not on every message). From there, the conversation continues in the detected language, with automatic translation when needed. How does ClaudIA handle attachments? Attachments are processed and can be used to enrich the reply. Details in the specific FAQ. Content and agents What are N1, N2, and Interactive content? - N1 — the basis for ClaudIA's direct replies - N2 — guide transfers to a human - Interactive — trigger "another agent" (Controlled Flow) that drives the conversation end to end When is the Clarifier triggered? In two scenarios: - When there is not enough content to reply - When there is ambiguity (e.g., two pieces of content that could both apply) When does ClaudIA transfer to N2? When it identifies that the relevant content is N2. :::warning An excess of low-information N2 content can bias the system toward transferring too often. ::: Can I control how often Interactive flows repeat? Yes — you can limit how many times an interactive flow can repeat and define its start triggers. Auditing and continuous improvement How do I see what ClaudIA used to reply? In Auditing, click View details: you can see which pieces of content ClaudIA considered and which one it used. Can I edit content directly from Auditing? Yes. When you edit there, the update already applies to the next tickets, speeding up the improvement cycle. Best practices :::success - Keep an eye on the dashboard and metrics - Audit 5–10% of conversations weekly - Optimize content with question variations for the same answer — this improves coverage without inflating N2 - Use the Playground to test changes before publishing ::: What is the Playground for? To simulate replies and compare versions of settings/content. The tests are recorded as test conversations and can also be audited. Behavior settings What tone and instruction adjustments can I make? In Behavior → Base prompt, you can complement the prompt with company and ClaudIA context, define tone/empathy, and adjust style and tone of voice (line breaks, emoji use, jargon, slang) as well as the project-specific rules. Can I break up long messages? Yes. In Behavior → Message delivery → Split large messages, segmentation splits long replies into smaller parts. How does the first-message greeting work? ClaudIA recognizes the first message and can use the Initial greeting (dynamic), configured in Lifecycle → Greetings. If you enable the Static greeting, it takes precedence and the dynamic one no longer applies. And the fallback / business hours? You configure the Default business hours in Transfer → Human availability. Outside business hours, when ClaudIA needs to transfer, it sends the Out-of-hours message and avoids routing to someone who is unavailable (optionally being able to resolve as N1 outside business hours). What is the Problem Resolved Checker? It lives in Lifecycle → Automatic Resolution and checks with the customer whether the question was resolved before closing. It has two independent modes — you can enable one, the other, or both at the same time: - Scheduled — after a few minutes with no reply (defined in Minutes until the question), it sends a check-in ("Can I help you with anything else?") - On message (real time) — it evaluates each new customer message and reacts on the spot Based on the reply: if the customer confirms everything is fine → it moves to closing; if they ask a new question → it exits the cycle and keeps helping; if they don't reply → the ticket is closed by the neighboring Automatic closing block, using its own Minutes with no reply. Details in Problem Resolved Checker and in Automatic ticket closing at N1 (Ticket Resolver). What are "transfer detection" and "repeated sections limit"? They are mechanisms that monitor when to transfer (to avoid improper routing) and enforce limits when there are repeated attempts in the same session. The Repeated sections limit lives in Transfer → N2 Transfer. Content modeling tips How do I avoid transfer bias? - Create N2 content only when it truly requires a human - Give informational density to N2 content (the "when to transfer" should be clear) - Expand N1 with question variations to increase coverage without pushing cases to N2 How do I expand coverage without losing quality? For each N1 answer, add synonyms and alternative ways of asking. This reduces ambiguity, triggers the Clarifier less often, and improves the N1 resolution rate. Operational summary :::info - Full mirroring between the help desk and the platform - Per-message decisions: attachments, language (at the start), frustration, resolve/transfer/clarify/interactive flow - Transparent auditing with quick content editing - Flexible settings: style/tone, message segmentation, greeting, human availability, and fallback - Problem Resolved Checker (two independent modes) + Automatic closing on inactivity, with configurable times - Recommended routine: monitor metrics, audit 5–10%/week, iterate on content with variations ::: Notes - To start with the initial settings: How to do ClaudIA's initial and essential settings - To understand the auditing process: How ClaudIA works and the auditing process - To understand the Hub screen: What are the main screens of ClaudIA's Hub

Last updated on Jul 22, 2026