Guia de Utilização

Não precisa de uma chave de API para começar: um modelo alojado já está incluído, e os agentes do nível Gratuito executam automaticamente no pool partilhado da plataforma. Se o seu plano permitir o seu próprio fornecedor, vá para Ligar → Fornecedores, escolha Anthropic, OpenAI, ou outro fornecedor suportado, e cole a sua própria chave de API do painel desse fornecedor. A chave é validada com uma chamada real (não faturada) antes de ser guardada, e encriptada em repouso - assim que mostrar ATIVO, os seus agentes usam-na em vez do pool alojado.

Depois disso, a ordem natural de construção é: criar um Agente (Construir → Agentes), testá-lo privadamente no Playground (Testar → Playground), e depois ligá-lo a um Workflow para automação ou conectá-lo diretamente a um canal (WhatsApp, Telegram, e-mail) para que pessoas reais possam falar com ele.

Qualquer campo que peça um prompt de sistema ou descrição — o prompt de um agente, a descrição de uma coleção de conhecimento, etc. — tem um pequeno botão ✨ Perguntar à IA. Clique, descreva o que quer numa frase (ex: "um agente de suporte para reembolsos e estado de encomendas"), e o texto será redigido usando o seu provedor de LLM ativo. Nada é aplicado automaticamente — pode sempre rever a sugestão e clicar em Usar isto ou Regenerar.

Um agente é uma persona de IA: um prompt de sistema, um provedor/modelo de LLM e, opcionalmente, uma base de conhecimento e um conjunto restrito de ferramentas. Comece a partir de um modelo (triagem de suporte, assistente de pesquisa, etc.) para pré-preencher um prompt, ou comece do zero e use o "Perguntar à IA" para redigir um.

O acesso a ferramentas e o acesso a conhecimento são listas de permissões: deixe-as vazias para acesso "irrestrito" (o agente pode usar tudo o que está disponível), ou selecione itens específicos para o restringir. Isto é importante para agentes virados para o cliente — não vai querer que um bot de suporte público aceda a todas as ferramentas internas.

Carregue ficheiros .md, PDF, Word, imagens (OCR) ou áudio/vídeo (transcritos) e eles são divididos e incorporados num arquivo vetorial pesquisável. As Coleções são pastas que pode aninhar para limitar o acesso dos agentes — por exemplo, uma coleção "Política de Devoluções" que apenas certos agentes podem pesquisar.

Um agente só pesquisa a sua base de conhecimento se a opção "Anexar base de conhecimento" estiver marcada (ao criar ou na página de Agentes), e apenas dentro das coleções permitidas na sua lista de acesso.

A tela visual para automação de múltiplos passos: arraste e conecte nós (Gatilho, Agente, Pesquisa de Conhecimento, Condição, etc.). Cada nó chama o serviço real por trás dele — uma execução de Workflow genuinamente chama o seu agente, pesquisa o seu conhecimento e envia a mensagem de WhatsApp.

Os Workflows podem começar de três maneiras: manualmente (botão "Executar"), num horário (ex: "todas as manhãs às 8h"), ou através de um URL de webhook. Cada execução é registada passo a passo no separador Execuções do workflow, incluindo cada chamada de ferramenta feita por um nó de Agente.

Um mercado de servidores do Protocolo de Contexto de Modelo e ferramentas que um agente pode usar (pesquisa web, base de dados, scripts...). Ative as que deseja e depois defina quais agentes as podem usar no editor de acesso a ferramentas. Desativar um servidor aqui remove-o imediatamente de todos os agentes.

Em Admin → Canais, conecte o WhatsApp via Twilio (configuração rápida, taxa por mensagem) ou diretamente pela Plataforma WhatsApp Business da Meta (sem taxa de intermediário, mais configuração). Se ambos estiverem configurados, a conexão direta da Meta é usada automaticamente.

Quando um novo número de telemóvel envia uma mensagem pela primeira vez, aparece em Emparelhamentos de remetente pendentes e precisa de aprovação antes que os seus agentes conversem com ele. Isto impede que estranhos tenham conversas de IA não supervisionadas por defeito.

Emparelhe um telemóvel (Android ou iOS) na página Dispositivos, e um nó de Controlo de Dispositivo de um workflow pode tocar, digitar, abrir apps ou fazer capturas de ecrã. O Android suporta automação completa; o iOS está limitado a abrir apps. Consulte o CONSTRAINTS.md do SDK Móvel para todos os detalhes.

Utilizadores: convide colegas e atribua funções (apenas um admin do tenant pode alterar funções/credenciais). Aprovações: a caixa de entrada para intervenção humana, onde ações que necessitam de aprovação (ex: enviar uma mensagem de WhatsApp) aguardam. Registo de Auditoria: um registo completo de todas as ações significativas no seu tenant, por uma pessoa ou agente.

"No active providers yet" when creating an agent - you should not see this on a new account: every new account runs on the platform's hosted pool for its first 3 months, and the Free plan does after that. It appears once you are on a paid plan using your own provider - activate one under Connect → Providers.

O botão Perguntar à IA dá um erro - a mesma causa que a anterior. Só falha quando a sua conta está fora do pool alojado e não tem um fornecedor ativo próprio.

Um remetente pendente de WhatsApp/Telegram nunca recebe resposta - verifique em Admin → Canais se há um emparelhamento à espera da sua aprovação.

Uma ferramenta não aparece para um agente - confirme que está ativada em Ferramentas MCP e que a lista de acesso a ferramentas do agente a inclui ou está vazia (irrestrito).