Manual da Cobli

Ações do agente

Entenda o plano da IA, os cards de agente, as confirmações de ação e o que a Cobli IA consegue executar pelo chat.

Além de responder perguntas, a Cobli IA executa tarefas na sua frota — criar e ligar alertas, buscar veículos por endereço, gerar arquivos. Quando isso acontece, a conversa mostra o plano da tarefa, cards de agente com o andamento e, nas ações que alteram dados, um card de confirmação que espera a sua decisão.

As ações disponíveis variam por conta. Se um recurso descrito aqui não aparecer no seu chat, ele ainda não foi liberado para a sua frota.

Acompanhar o que a IA está fazendo

Quando a Cobli IA aciona um agente especialista, um card aparece na conversa com o nome do agente e o status atual:

  • Trabalhando — o agente está executando; um indicador de carregamento fica visível.
  • Concluído — o agente terminou. O card permanece alguns segundos e some.
  • Não foi possível concluir — o agente falhou. Refaça o pedido ou reduza o escopo.

Os agentes aparecem com nome próprio quando existe um — por exemplo Agente de Agendamento e Agente de Arquivos. Sem nome específico, o card mostra Agente especialista.

Enquanto o agente trabalha, o card também informa a etapa em andamento — a ferramenta ou a habilidade em uso naquele instante:

EtapaO que está acontecendo
Definindo o padrão do arquivoO agente está estabelecendo o modelo do documento a ser gerado
Consultando o padrão do arquivoO agente está lendo o modelo já definido
Preparando o arquivoOrganização dos dados que vão para o arquivo
Gerando o arquivoMontagem do arquivo em si
Executando a operaçãoProcessamento em andamento
Disponibilizando o arquivoEnvio do arquivo para você baixar
Aplicando a identidade visualAplicação do logo, cores e tipografia da frota

Nesse período, a linha genérica de "processando" some — o card passa a ser a única fonte de progresso.

A identidade visual aplicada nos arquivos vem das Configurações da Cobli IA. Se o logo ou as cores estiverem errados, reprocesse o onboarding por lá.

Acompanhar o plano da tarefa

Em pedidos com várias etapas, a Cobli IA pode mostrar na conversa um card chamado Plano, com a lista do que ela pretende fazer. Assim você vê o que já foi feito e o que ainda falta, sem esperar a resposta final.

O título do card traz um contador de etapas concluídas — por exemplo, Plano · 2/5. Cada etapa da lista mostra o seu estado por um ícone:

EstadoO que significa
PendenteA etapa ainda não começou
Em andamentoA Cobli IA está executando esta etapa agora (ícone de carregamento)
ConcluídaA etapa terminou (ícone de confirmação)

Abaixo da etapa Em andamento, o card mostra em texto discreto o que a Cobli IA está fazendo naquele instante — por exemplo Pensando... ou o nome da ferramenta em uso, como Lendo arquivo. Enquanto essa linha aparece no plano, a linha genérica de "processando" no fim da conversa não é exibida, para você não ver o mesmo aviso duas vezes. Se a Cobli IA estiver só processando, sem uma ferramenta ou raciocínio específico, a etapa mostra apenas o ícone de carregamento. Essa linha aparece somente no plano da resposta mais recente.

O plano é atualizado no próprio card, conforme as etapas avançam. Existe só um card de plano por resposta: ele mostra sempre a versão mais recente, e não uma lista de versões anteriores.

Enquanto houver etapas para concluir, o card fica aberto. Quando todas terminam, ele recolhe sozinho e mostra só o título e o contador (por exemplo, Plano · 5/5). Clique no título para abrir ou recolher a lista a qualquer momento — a sua escolha é mantida até o plano mudar de situação (por exemplo, ao concluir a última etapa).

O plano aparece apenas quando a Cobli IA decide organizar o pedido em etapas; perguntas simples costumam ser respondidas sem ele. Ao reabrir uma conversa antiga, o card mostra a última situação registrada do plano.

Confirmar ações que alteram a frota

Algumas ações não são executadas sem a sua autorização. Nesses casos, a conversa exibe o card Confirmação necessária com a mensagem "A Cobli IA precisa da sua autorização para executar esta ação."

O card mostra:

  • O que será feito, em linguagem de operação — por exemplo Excluir veículo ou Excluir 3 veículos.
  • O veículo envolvido pela placa, apelido e modelo. Quando o veículo não pode ser identificado, o card exibe Veículo não identificado em vez de códigos internos.
  • Informações complementares do pedido, como o Motivo.

Revise o que será executado

Confira o alvo da ação — principalmente a placa e a quantidade de veículos — antes de decidir.

Confirme ou recuse

Clique em Confirmar para autorizar ou em Recusar para cancelar. A conversa retoma automaticamente depois da decisão, sem que você precise repetir o pedido.

Acompanhe o resultado

O card assenta em um dos três estados finais: confirmado, recusado ou não foi possível concluir. O estado fica registrado na conversa — ao reabrir o histórico, o card não volta a pedir confirmação.

Enquanto o card está na tela, a IA fica parada aguardando você. O indicador de "processando" não aparece nesse período porque não há nada sendo executado.

Avisos de impacto

Antes de ações que mudam dados, a Cobli IA pode exibir um card de alerta com a lista de Impactos — o que muda na frota se a ação for adiante. Os avisos vêm em três níveis: informativo, atenção e crítico.

Leia os impactos antes de confirmar. Eles descrevem efeitos que não ficam visíveis na frase da ação, como registros que deixam de existir ou automações que param de valer.

Confirmações de ações em serviços externos

Quando a Cobli IA for escrever dados em um serviço externo conectado — como criar uma planilha no Google Planilhas, enviar um e-mail pelo Gmail ou salvar um arquivo no Google Drive — ela exibe um card de confirmação específico para aquele serviço.

O card exibe:

  • O ícone da conta do serviço envolvido (Google Planilhas, Gmail, Google Drive e outros)
  • O tipo de ação que será executada em linguagem de operação — por exemplo Ação na sua conta Google Planilhas
  • Uma descrição do que será feito
  • Os detalhes da ação (como o nome da planilha ou o destinatário do e-mail), quando disponíveis

Confirme ou recuse como em qualquer outra ação do agente. A conversa retoma automaticamente depois da decisão.

Quando a Cobli IA precisa de uma conta conectada

Se a Cobli IA tentar executar uma ação que exige acesso a um serviço que ainda não foi conectado, ela exibe um card de conexão na conversa com:

  • O ícone e o nome do serviço necessário
  • Uma breve descrição de por que o acesso é necessário
  • O botão Conectar [serviço]

Clique no botão para iniciar o processo de autorização. Após conectar, um banner aparece na conversa confirmando a conexão — clique em Retomar pedido para que a Cobli IA execute o que você havia pedido sem precisar repetir o pedido.

Se a conexão falhar ou for cancelada, o banner exibe uma mensagem de erro com orientações para tentar novamente. Saiba mais em Conectores.

Criar e gerenciar alertas da frota pelo chat

A Cobli IA cria, lista e liga/desliga alertas usando as mesmas regras da tela Alertas.

  • Criar — peça o alerta em linguagem simples, informando o tipo, a abrangência (veículos ou grupos), os dias da semana e a faixa de horário. São 15 tipos criáveis pelo chat.
  • Listar — peça a relação dos alertas já configurados na frota.
  • Ligar e desligar — ative ou desative um alerta existente sem sair da conversa.

Alterar as condições de um alerta existente continua sendo feito no painel. Pelo chat é possível criar, listar e ligar/desligar — para mudar critérios de um alerta já criado, use a tela Criar uma regra de alerta.

Encontrar veículos por endereço ou região

Você pode pedir veículos próximos de um endereço ou dentro de uma região:

  • Por proximidade — informe o endereço e o raio desejado, de 100 metros a 50 km. O resultado vem ordenado por distância.
  • Por região — informe bairro, cidade ou área para ver os veículos que estão ali.

Exemplos: "quais veículos estão a até 2 km da Av. Paulista, 1000?" ou "liste os veículos que estão em Contagem agora".

Dicas

Se um card de agente ficar em Não foi possível concluir, refaça o pedido com um recorte menor — menos veículos, período mais curto ou um objetivo por vez.

Ações confirmadas pelo chat valem da mesma forma que as feitas nas telas do painel. Confirme apenas o que você faria manualmente.

Veja também

Nesta página