Agentes
As etapas de agente rodam no Mate, com a sua própria chave de IA ou no seu próprio runner: adicione uma chave, veja modelos, limites e o histórico.
Um agente é uma IA que executa a etapa de agente de uma automação: ele lê o registro que iniciou a automação, usa as mesmas ferramentas de CRM do Mate e relata o que fez. Onde um agente roda é o runtime da etapa: Mate (o agente hospedado do Customermates, pago com os créditos de IA do seu plano, somente Cloud), Sua própria chave (um agente na nuvem do Customermates ou na sua instância auto-hospedada que usa uma chave de API do seu provedor de IA, cobrada pelo provedor) ou Seu próprio runner (Claude Code ou Codex na sua própria máquina, com o seu próprio login).
Abra Agentes, nas configurações, para ver quais runtimes estão disponíveis, adicionar chaves de provedor, ver os runners do espaço de trabalho e ler as últimas execuções. A página é para quem pode alterar as configurações do espaço de trabalho.
Como adiciono uma chave de provedor?
Abra Agentes, clique em Adicionar chave e escolha o Provedor (Anthropic, OpenAI ou Google). Dê um Rótulo à chave, cole a Chave de API do console do provedor e escolha um Modelo padrão. O Customermates pergunta ao provedor se a chave funciona antes de guardá-la. Uma chave que o provedor recusa não é salva, e se o provedor não puder ser alcançado no momento, você é convidado a tentar de novo. Uma chave que o provedor aceita, mas que não pode listar os modelos, por exemplo uma chave restrita da OpenAI, é salva com uma nota informando que não foi possível verificá-la.
A chave é guardada criptografada e nunca mais é exibida: a lista mostra apenas o rótulo, o provedor e os quatro últimos caracteres. Um espaço de trabalho tem uma chave por provedor, então adicionar uma chave para um provedor que já tem uma a substitui. Testar pergunta de novo ao provedor e atualiza Última verificação, Remover exclui a chave de forma definitiva. Se o segredo de criptografia do servidor mudou depois que a chave foi salva, Testar e as execuções de agentes informam que a chave não pode ser lida, e você a salva de novo. As chaves funcionam em todos os planos pagos e em instâncias auto-hospedadas, onde a chave é sua de qualquer forma; o plano Free não pode adicionar nenhuma.
Quanto custa?
Um agente com a sua própria chave custa o que o provedor cobra pelas chamadas, na fatura do provedor. Ele não usa os créditos de IA do seu plano do Customermates. Um agente no Mate usa os créditos da pessoa dona da automação, a mesma cota que os chats do Mate e as rotinas usam, e cada execução mostra os créditos usados. Uma execução no Mate reserva créditos rodada a rodada e para antes de usar mais de 10 créditos ou mais do que resta dessa cota.
Quais modelos posso usar?
A lista por provedor é mantida pelo Customermates e mostra os modelos dos provedores para os quais você adicionou uma chave:
- Anthropic: Claude Sonnet 5.5 (o padrão), Claude Opus 5.5, Claude Haiku 5.5, Claude Sonnet 4.5 e Claude Haiku 4.5.
- OpenAI: GPT-5 mini (o padrão), GPT-5, GPT-5 nano, GPT-4.1 e GPT-4.1 mini.
- Google: Gemini 2.5 Flash (o padrão), Gemini 2.5 Pro e Gemini 2.5 Flash-Lite.
Uma etapa salva sem modelo mantém a partir de então o modelo padrão da única chave de provedor do espaço de trabalho. Com várias chaves a etapa precisa de um modelo, para que remover uma chave nunca mova uma etapa para outro provedor. Quando o modelo padrão de uma chave não é mais oferecido, a execução usa o modelo padrão do provedor e informa isso na transcrição. O Customermates nunca pede um login do Claude Pro ou Max: o runtime com chave própria funciona apenas com uma chave de API do console do provedor.
O que uma etapa de agente pode fazer?
Uma etapa de agente roda como dono da automação, com as permissões dele, sem que ninguém acompanhe. Ela pode ler e alterar registros, ler a base de conhecimento e usar as demais ferramentas de espaço de trabalho do Mate. Ela não pode usar a interface e não tem pesquisa na web. Tudo o que exige aprovação, como excluir registros ou convidar pessoas, é recusado e o agente relata o que falta.
Uma execução tem dois limites: no máximo 25 chamadas de ferramentas e 10 minutos. Quando um limite é atingido, a execução para e informa. Quando o evento que iniciou a automação vem de fora do espaço de trabalho, por exemplo um formulário, um webhook ou uma mensagem recebida, o agente trata o registro e tudo o que há nele como dados, nunca como instruções. O mesmo vale para o nome de um registro que a instrução usa com {{record.name}}: ele chega ao agente marcado como dado e limitado a 200 caracteres. Uma execução que um texto de fora pode alcançar por um desses caminhos não pode enviar e-mails nem mensagens de chat, enviar convites de conexão, nem criar, alterar ou iniciar webhooks e rotinas: o agente diz no relatório o que deveria ser enviado ou alterado. O mesmo vale quando o registro que iniciou a automação foi escrito por um formulário público, um webhook de entrada ou uma etapa de agente que um texto de fora podia alcançar, seja qual for o gatilho da automação. Nenhuma etapa de agente cria, altera ou exclui páginas da base de conhecimento. Do mesmo modo, nenhuma etapa de agente inicia uma rotina, nem cria ou altera uma rotina que reage a eventos, porque uma rotina assim poderia iniciar a automação de novo sem fim. Uma etapa iniciada por uma mensagem recebida é informada de qual conversa ler. Uma execução interrompida depois de iniciada, por exemplo por uma reinicialização do servidor, nunca é iniciada uma segunda vez, porque pode já ter enviado ou alterado algo: ela termina como tempo esgotado poucos minutos depois de o limite de tempo dela vencer. Um espaço de trabalho executa no máximo cinco etapas de agente ao mesmo tempo no Mate ou na própria chave; as demais esperam na fila até que uma termine. Uma execução que não pôde ser iniciada é tentada de novo em poucos minutos e termina como tempo esgotado se, depois de 15 minutos, ainda não tiver começado. Uma execução que falha por causa do provedor mostra a classe de erro do provedor, nunca a chave.
Onde vejo o que um agente fez?
Execuções recentes dos agentes na página Agentes lista as execuções, as mais recentes primeiro, com o status (Na fila, Iniciando, Em andamento, Concluída, Falhou, Tempo esgotado ou Cancelada), o runtime, o modelo, os tokens e, no Mate, os créditos usados. Abra uma execução para ler a transcrição: a instrução, cada ferramenta chamada com um breve resumo dos argumentos, um breve resumo de cada resultado e o relatório final. As execuções são guardadas por 90 dias. Quem vê todas as automações vê todas as execuções, os demais veem as das próprias automações. A instrução, a transcrição e o relatório final de uma execução são mostrados apenas ao dono da automação e aos administradores; as demais pessoas que veem a execução veem o status, o runtime, o modelo, os tokens e os horários.
Para agentes
A etapa de agente é o efeito agent de uma regra em manage_rules via MCP: runtime é mate, ownKey ou runner, prompt é a tarefa (pode usar {{record.name}} e {{rule.name}}), model escolhe para ownKey um modelo do provedor da chave e runnerId fixa para runner um runner específico. Um runtime indisponível faz o efeito falhar com o motivo plan, noKey, noRunner, selfHosted ou notConfigured.
Perguntas frequentes
Posso usar minha assinatura do Claude Pro ou Max?
Não. O Customermates executa os agentes com uma chave de API do console do provedor, que o provedor cobra por uso. Um login do Claude Pro ou Max pertence ao próprio Claude e não é usado pelo Customermates.
Minha chave está segura?
A chave é verificada com o provedor, guardada criptografada e não é exibida novamente em lugar nenhum, nem para administradores. Ela é aberta apenas durante uma execução, para as chamadas dessa execução ao provedor, e nunca é gravada no histórico de execuções.
Por que Sua própria chave não está disponível?
A página Agentes informa o motivo ao lado de cada runtime: seu plano não o inclui, ou nenhuma chave de provedor foi adicionada ainda. Um runner está disponível se algum foi visto nos últimos dois minutos.
Uma execução continua se eu fechar a página?
Sim. Uma execução é iniciada no servidor pela automação e termina lá. A página apenas mostra o que foi registrado.