Agentes de IA: Limitações Conhecidas e Soluções Alternativas

Os agentes de IA são poderosos, mas existem algumas limitações em nível de plataforma que você precisa conhecer. Use as soluções alternativas recomendadas abaixo para garantir que seu agente se comporte de forma consistente e confiável.

Visibilidade da conversa

Agentes de IA têm visibilidade limitada sobre metadados da conversa, histórico e contexto interno.

Metadados do canal e da origem

Agentes de IA recebem automaticamente um contexto básico do canal, incluindo o tipo de canal, o nome do canal e o ID do canal. Com as instruções adequadas, seu Agente de IA pode usar isso para ajustar o comprimento das respostas, a formatação, o tom e o comportamento para se adequar a diferentes canais.

Atribuição de anúncios da Meta e do TikTok

Quando uma conversa é aberta a partir de um Anúncio Click-to-Chat da Meta ou de um Anúncio de Mensagens do TikTok, seu Agente de IA recebe automaticamente um bloco de Contexto de Anúncios juntamente com o contexto do canal. Nenhuma configuração é necessária. Este bloco inclui:

• Plataforma do anúncio: Meta ou TikTok

• Ad Campaign: The campaign name

• Grupo de anúncios: O nome do grupo ou do conjunto de anúncios (quando disponível)

• Nome do anúncio: O nome do anúncio individual ou da criativa (quando disponível)

Isso significa que você pode escrever instruções que se adaptem ao anúncio de onde um Contato veio. Por exemplo, iniciar com uma mensagem específica da campanha, direcionar para uma equipe diferente ou acionar um fluxo de conversa diferente.

Observação: O bloco de Contexto de Anúncios só é incluído se o evento de entrada do anúncio ocorreu dentro das últimas 20 mensagens da conversa. Se a conversa tiver avançado além dessa janela, nenhum contexto de anúncio é incluído. Se um Contato abriu mais de um anúncio nas últimas 20 mensagens, apenas a entrada do anúncio mais recente é incluída. Escreva suas instruções para tratar ambos os casos.

Limitações a ter em conta:

• O contexto do canal e da origem são fornecidos em alto nível. Embora seu Agente de IA receba automaticamente metadados estruturais (como plataforma do anúncio, campanha e nome do anúncio), ele não tem visibilidade do conteúdo real do anúncio. Você ainda precisará escrever instruções que digam ao seu Agente de IA o que fazer com base nesse contexto e sobre o que é o anúncio.

• Agentes de IA não recebem metadados de origem automaticamente, exceto quando uma conversa é iniciada a partir de um anúncio pago da Meta ou do TikTok, o que fornece o bloco de Contexto de Anúncios descrito acima.

Solução alternativa recomendada:

Se o seu caso de uso depende de saber de onde um Contato veio fora dos anúncios pagos, use um Fluxo de trabalho para capturar informações, como o conteúdo do anúncio, e armazená-las em um Campo de Contato.

Por exemplo:

• Crie um Fluxo de trabalho com um gatilho Conversa iniciada

• Adicione condições com base no canal ou na origem

• Atualize um Campo de Contato, como Origem do lead ou Nome da campanha

Você pode então instruir seu Agente de IA a consultar esse campo de contato nas suas instruções. Isso garante um comportamento consistente e confiável, mesmo quando os detalhes do canal ou da origem não estão disponíveis automaticamente.

Exemplos de prompts para comportamento adaptado ao canal

Você pode orientar seu Agente de IA a adaptar suas respostas, instruindo‑o explicitamente sobre como se comportar em diferentes canais. Aqui estão alguns exemplos que você pode usar:

Ajuste o comprimento e o tom das respostas

Se esta conversa ocorrer no Instagram ou no TikTok, mantenha as respostas curtas (1–3 frases), amigáveis e conversacionais. Evite explicações longas.

Se esta conversa ocorrer no WhatsApp, você pode fornecer respostas mais detalhadas, mas mantenha‑as concisas e fáceis de ler.

Se esta conversa ocorrer por Email, use um tom mais estruturado e formal. Explicações mais longas e respostas com formatação clara são aceitáveis.

Controle a formatação e o conteúdo

Não compartilhe links ao responder no TikTok, a menos que o Contato solicite explicitamente um link.

Ao responder por Email, você pode incluir links, marcadores e instruções passo a passo quando apropriado.

Comportamento e escalonamento baseados no canal

Se a conversa ocorrer no Instagram ou no Facebook e o Contato perguntar sobre cobrança, pagamento ou questões relacionadas à conta, escale imediatamente para um agente humano.

Se a conversa ocorrer no WhatsApp, tente primeiro uma solução básica antes de escalar, a menos que o Contato pareça frustrado.

Referindo‑se à conversa

Ao referir‑se ao local de onde o Contato está enviando mensagens, diga “este chat” ou “esta conversa”. Nunca mencione o nome do canal explicitamente.

Assignment awareness

AI Agents receive an Assignment Event when they are assigned to a conversation. This helps the AI Agent understand that it has just been assigned and decide what to do next.

This applies when an AI Agent is assigned by:

• A human agent

• A Workflow

• Another AI Agent

This means you can now instruct your AI Agent to act based on assignment events. For example, you can ask it to:

• Greet the Contact when it is assigned to the conversation.

• Fetch Contact data or route the conversation based on your instructions.

• Route the conversation to the correct team if the Contact has clearly stated their problem.

• Continue the handoff when AI Agent 1 assigns the conversation to AI Agent 2.

Example prompt:

When you are assigned to a conversation, greet the Contact and check their latest message. If they have clearly stated their issue, route the conversation to the correct team. If not, ask how you can help.

Limitations to be aware of:

• The Assignment Event only applies when an AI Agent is assigned, not when a human agent or team is assigned.

• It does not apply when an AI Agent is unassigned or removed.

• The event is only available within the AI Agent’s 20-message context window.

• If multiple events happen in the same conversation, only the most recent event is available to the AI Agent. For example, if a Workflow is configured to assign an AI Agent when a conversation is reopened, the Assignment Event is kept because it happens after the Reopened Event.

Conversation reopen awareness

AI Agents receive a Conversation Reopened Event when a closed conversation is reopened by an incoming Contact message.

This helps AI Agent understand that the Contact is returning to an existing conversation instead of starting a new one.

This means you can now instruct your AI Agent to act based on reopened conversation events. For example, you can ask it to:

• Identify when a Contact has replied to a closed conversation.

• Respond differently to simple acknowledgement messages such as “thanks”, “ok” or “got it”.

• Continue helping if the Contact sends a genuine follow-up question.

Limitations to be aware of:

• The Reopened Event does not apply when a snooze period expires without a new incoming Contact message.

• If multiple events happen in the same conversation, only the most recent event is available to the AI Agent. For example, if a Workflow is configured to assign an AI Agent when a conversation is reopened, the Assignment Event is kept because it happens after the Reopened Event.

• The event is only available within the AI Agent’s 20-message context window.

Example prompt:

When a conversation is reopened, check if the Contact's message is a simple acknowledgement, such as "thanks", "ok" or "got it". If so, close the conversation. If it is a genuine follow-up question, continue assisting the Contact.

Atribuição por ferramentas externas

Quando um Agente de IA é atribuído a uma conversa por uma ferramenta externa — como Developer API, n8n, ou Make.com — a própria atribuição não fará com que o Agente de IA responda.

Este é um comportamento esperado. Respond.io restringe isso para evitar que Agentes de IA respondam em massa quando várias conversas são atribuídas simultaneamente por automação.

Após a atribuição, a conversa aparecerá como atribuída ao Agente de IA. No entanto, o Agente de IA não enviará uma mensagem proativa. O Agente de IA responderá assim que o Contato enviar uma mensagem.

Nota: Não há solução alternativa para essa limitação.

Contexto interno e histórico de mensagens

Agentes de IA não podem ver comentários internos e só conseguem acessar as 20 mensagens mais recentes em uma conversa.

Por causa disso, os Agentes de IA não devem confiar na origem do canal, em notas internas ou em contextos de conversas mais antigas ao tomar decisões.

Solução alternativa recomendada:

Armazene contexto importante em Campos de Contato ou estágios do ciclo de vida, e instrua o Agente de IA a consultá-los em vez disso.

Por exemplo:

• Use Fluxos de trabalho ou processos manuais para manter campos como Tipo de plano, Status do cliente ou Categoria do problema atualizados

• Use estágios do ciclo de vida (por exemplo, Novo lead, Lead qualificado, Cliente) para orientar como o Agente responde

• Nas instruções do seu Agente de IA, referencie explicitamente esses campos (por exemplo, "Se o ciclo de vida for Cliente, priorize respostas relacionadas ao suporte.")

Isso garante que o Agente de IA possa tomar decisões consistentes usando dados estruturados e confiáveis, mesmo com acesso limitado a mensagens antigas ou comentários internos.

Replied-to messages

AI Agents cannot see the message a Contact is replying to. When a Contact uses the reply feature to quote an earlier message, the AI Agent receives only the new incoming message — not the original message being replied to.

This applies regardless of how recent or old the replied-to message is. The AI Agent has no visibility into the quoted message, even when it falls within the most recent 20 messages.

As a result, the AI Agent may give incomplete or contextually wrong responses when a Contact replies to an older message and assumes the AI Agent understands the full thread.

Solução alternativa recomendada:

Write your AI Agent instructions to ask the Contact to restate their request when the message lacks context. When a human agent takes over, review the replied-to message manually before responding.

Note: Support for passing the replied-to message to the AI Agent is being considered. Vote for or follow the reply-to message support feature request to track progress.

Capacidades externas

Agentes de IA operam principalmente dentro do respond.io, mas agora podem interagir com sistemas externos usando a AI Agent action: Make HTTP requests. Isso permite que os Agentes de IA chamem APIs externas para obter dados em tempo real ou acionar ações em sistemas de terceiros.

Saiba mais sobre AI Agent action: Make HTTP requests here.

Tipos de mensagem e anexos

AI Agents can send files and images as rendered attachments directly in the conversation. When an AI Agent’s response includes a valid file or image URL, it delivers the file as an actual attachment — the same way human agents and Workflows send files today.

• Image files (.jpg, .jpeg, .png) render as inline previews

• Document files (.pdf, .docx, .pptx) appear as file chips with filename and type

• All attachments appear in the conversation’s Attachments tab

How to enable it:

1. Add file or image URLs to your AI Agent’s Knowledge Sources or Instructions.

2. Add this instruction to your AI Agent prompt: “Send image/file as attachment whenever there’s a valid image/file URL from Knowledge source or Instructions.”

Using the Make HTTP requests action? Image or file URLs returned in the API response can be sent as attachments the same way — see Sending images or files from the API response.

Limitations:

• Supported file types: .pdf, .docx, .pptx, .jpg, .jpeg, .png — other URL types stay as plain text

• Login-gated URLs (private Google Drive, Dropbox) are not supported in this release

• Maximum of 5 attachments per AI Agent response — additional URLs are dropped

• AI accuracy may vary with complex URLs in Knowledge Source (known limitation)

• Videos, voice notes, stickers, and other rich media remain unsupported

For unsupported file types or login-gated assets, use a Workflow step or assign to a human agent.

Best practices to reduce hallucinated or wrong attachments:

• Use simple URLs — avoid long query strings or redirect chains.

• Give each item a unique, clearly labeled URL — near-identical URLs confuse the AI (e.g. image001.png, image010.png).

• Avoid URL shorteners, redirects, or login/CAPTCHA-protected links — these can’t be rendered as attachments anyway.

• Add the trigger instruction only in your agent’s Instructions, not inside the Knowledge Source — mixing the two can cause unpredictable behavior.

Receiving unsupported messages

When a Contact sends a message type that respond.io cannot process, such as a message reaction or other unsupported format, the AI Agent receives an [Unsupported message] signal in the conversation history.

This means your AI Agent is now aware when an unsupported message is received and can respond accordingly. You can also write instructions to customize how your AI Agent handles these cases.

Example prompts for handling unsupported messages:

Ask the Contact to resend as text:

If you receive [Unsupported message], reply: "It looks like I wasn't able to receive your last message. Could you send it as a text message instead?"

Ignore and do nothing:

If you receive [Unsupported message], do not reply. Wait for the Contact's next message.

Acknowledge without mentioning the limitation:

If you receive [Unsupported message], reply: "I'm not able to view that message type. Feel free to describe what you need and I'll be happy to help!"

Configuração do modelo

Agentes de IA não suportam definições manuais de temperatura porque modelos de IA mais recentes não expõem mais controles de temperatura.

Se você quiser ajustar a “criatividade” do Agente de IA (semelhante à temperatura), a melhor abordagem é solicitá‑la diretamente nas suas Instruções. Por exemplo, você pode orientar a IA a agir de forma mais criativa ou mais rígida, dependendo do seu caso de uso.

Alta criatividade (maior “temperatura”):

Responda calorosamente e de forma criativa no tom do cliente.

Baixa criatividade (menor “temperatura”):

Responda à pergunta do cliente usando apenas as fontes de conhecimento da empresa fornecidas e o histórico da conversa. Não suponha nem adicione informações novas.

Isso dá a você melhor controle sobre o tom e a consistência sem precisar de uma configuração dedicada de temperatura.

Silent mode (background tasks only)

In some use cases, you may want your AI Agent to perform background tasks — such as updating Contact Fields, adding Tags, or updating Lifecycle stages — without sending any message to the Contact.

By default, AI Agents generate a reply in every turn. To suppress all outgoing messages, add the following prompt at the top of your AI Agent's Instructions:

# CORE RULE: NO-REPLY POLICY (MANDATORY)- You MUST NOT generate or send any user-facing message under any circumstance (no greetings, no questions, no confirmations).- If the system requires a response payload, return an empty response only (e.g., response: ""). Do not include any other text.

When to use this:

• Your AI Agent is only used to classify conversations (e.g., update Tags or Contact Fields based on message content)

• Your AI Agent performs routing or assignment logic before handing off to a human agent or another AI Agent

• Your automation requires an AI Agent step for decision-making, but the Contact-facing reply is handled elsewhere

Important considerations:

• Place the no-reply instruction at the very top of your Instructions to ensure it takes priority over all other prompts.

• Always test this in a test conversation before publishing, as the AI Agent may still occasionally generate a response depending on the complexity of your other instructions.

• If your AI Agent also performs actions (e.g., Assign Conversation, Close Conversation), those actions will still execute normally — only the text reply is suppressed.

• When an AI Agent is assigned to a conversation, the message composer is disabled for human agents. This means you cannot use a silent AI Agent for background tasks while manually replying to the Contact at the same time.