English
Español
Sara Agente de Frete - Confirma Fácil
O Agente de Frete é uma solução de inteligência artificial voltada à gestão do ciclo completo de ofertas de frete — desde a criação da oferta até a contratação via leilão —, com foco em economia e compliance para a operação do embarcador.
Este guia foi elaborado para apoiar você no uso do Agente de Frete, mostrando como criar prompts eficazes e aplicá-los no dia a dia da gestão de fretes. Com as práticas deste guia, você poderá:
- Consultar e analisar ofertas de frete em tempo real, com visibilidade sobre status, urgência e desvios de valor.
- Obter rankings e comparativos de transportadoras por custo, participação e taxa de sucesso em leilões.
- Calcular métricas estratégicas como custo médio, economia gerada e tempo médio de contratação.
- Apoiar decisões de compra de frete com base em dados históricos, valor ideal (IA) e valor sugerido.
Importante
O Agente de Frete está disponível exclusivamente para embarcadores cadastrados na Plataforma de Fretes. Para saber mais, entre em contato com seu gerente de conta.
O que é o Agente de Frete?
O Agente de Frete é uma IA generativa integrada à Plataforma de Fretes. Ele funciona como um assistente digital especializado em cotação, contratação e análise de leilões de frete, capaz de consultar dados sobre ofertas ativas e históricas, identificar desvios de custo e emitir análises técnicas e estratégicas.
O agente atende dois perfis de usuário:
| Perfil | Foco |
|---|---|
| Gestor Logístico | Análise de desempenho, métricas de eficiência e decisões estratégicas. |
| Operador Logístico | Execução operacional, negociação com transportadoras e acompanhamento de ofertas em aberto. |
O modelo de contratação opera por meio de leilões de frete, nos quais transportadoras cadastradas competem pelo menor valor para uma oferta. O agente analisa os dados desses leilões para gerar insights e apoiar decisões de forma proativa.
Pré-requisitos e configurações
Para usar o Agente de Frete, é necessário garantir que os pré-requisitos abaixo sejam atendidos:
- Ter acesso ativo à plataforma de frete como Embarcador.
- Ter ao menos um perfil de usuário habilitado: Gestor Logístico ou Operador Logístico.
- Habilitar o acesso ao chat do Agente de Frete nas configurações da plataforma:
- Menu: Configurações > Sistema > Integrações > SeniorX > Agente de Fretes
- Informar os dados: Tenant Name, Access Key e Secret Key
- As ofertas de frete devem estar corretamente registradas na plataforma com os campos obrigatórios preenchidos.
O que o agente pode responder?
Com base nos dados disponíveis na plataforma, o Agente de Frete pode responder a perguntas relacionadas a:
Visão estratégica e gerencial — Gestor Logístico
- Qual é o valor total de fretes contratados no último mês?
- Qual é a taxa de sucesso na contratação de fretes?
- Qual é o custo médio por frete no período?
- Quais transportadoras mais participaram dos leilões?
- Qual é o tempo médio entre a abertura e a contratação do frete?
- Qual estado de origem tem o maior número de ofertas?
- Quais estados têm os fretes mais caros e mais baratos?
- Quais fretes apresentam maior desvio entre lance vencedor e valor ideal?
- Quais estados têm maior taxa de fretes não contratados?
- Qual a relação entre a distância
{{origem}}—{{destino}}e o valor do frete?
Execução operacional e acompanhamento — Operador Logístico
- Quais fretes têm maior urgência de coleta hoje?
- Quais transportadoras oferecem os menores valores nos leilões?
- Quais fretes têm maior peso ou volume, e qual é o custo médio?
- Qual o valor médio do frete por estado de destino?
- Quais fretes têm origem em
{{cidade}}/{{UF}}e destino em{{cidade}}/{{UF}}? - Qual é o valor médio dos lances vencedores?
- Quais cidades têm mais fretes não contratados?
- Quais fretes têm a maior diferença entre lance vencedor e valor ideal?
Alertas operacionais
O agente sinaliza automaticamente situações críticas com os seguintes marcadores:
| Marcador | Situação | Critério |
|---|---|---|
| 🔴 URGENTE | Coleta em até 24h sem contratação | data_coleta entre hoje e hoje +24h e lance_vencedor NULL |
| 🟡 ATENÇÃO | Coleta em até 48h ou frete acima do ideal | data_coleta entre 24h e 48h, ou lance_vencedor > valor_ideal |
| 🟢 OK | Frete contratado dentro do valor ideal | lance_vencedor ≤ valor_ideal e oferta fechada |
Quais informações o agente acessa?
O Agente de Frete utiliza os seguintes dados registrados na plataforma:
Dados da oferta de frete
| Campo | Descrição |
|---|---|
numero_oferta | Identificação única da oferta de frete |
data_coleta | Data prevista para coleta do frete |
data_previsao | Data prevista para entrega do frete |
data_fim | Data limite para a oferta receber lances |
dataCriacao | Data de criação da oferta pelo embarcador |
data_lanceAprovado | Data em que a oferta foi fechada/aprovada |
aprovadorOferta | Usuário responsável por aprovar a oferta |
Dados logísticos e de carga
| Campo | Descrição |
|---|---|
origem_cidade / origem_uf | Cidade e estado de origem do frete |
destino_cidade / destino_uf | Cidade e estado de destino do frete |
tipo_carga | Tipo de carga transportada |
peso_bruto | Peso bruto da carga (kg) |
volumes | Quantidade de volumes transportados |
modalidade | Tipo de transporte: Lotação ou Fracionado |
necessita_rastreio | Se a oferta exige veículo rastreado pela transportadora |
necessitaSeguroProprio | Se o embarcador utilizará seguro próprio |
Dados financeiros e de leilão
| Campo | Descrição |
|---|---|
lance_vencedor | Valor do lance vencedor da oferta |
lance_valor_original | Valor original do lance antes de ajustes e negociação |
maior_lance | Maior lance registrado na oferta |
valor_ideal | Valor ideal sugerido pela IA da plataforma |
valor_sugerido | Valor que o embarcador estava disposto a pagar |
quantidade_lances | Total de lances recebidos pela oferta |
nome_transportadora | Razão social da transportadora vencedora |
lead_time | Prazo de entrega informado pela transportadora (dias) |
Nota
Regra para valores ausentes:
- Se
valor_idealforNULL, o cálculo de desvio do ideal será omitido. - Se
valor_sugeridoforNULL, o cálculo de economia gerada também será omitido. - O agente informará ao usuário quando esses dados não estiverem disponíveis.
Métricas calculadas pelo agente
O agente calcula automaticamente as seguintes métricas com base nos dados disponíveis:
| Métrica | Fórmula |
|---|---|
| Custo Médio por Frete | Soma dos lance_vencedor ÷ total de fretes contratados |
| Tempo Médio de Contratação | Média de dias entre dataCriacao e data_lanceAprovado |
| Economia Gerada | Diferença entre (valor_sugerido − lance_vencedor) quando abaixo do sugerido |
| Fretes Acima do Ideal | Ofertas onde lance_vencedor > valor_ideal |
| Média de Lances por Oferta | Total de lances recebidos ÷ total de ofertas |
| Taxa de Contratação | Fretes com lance_vencedor preenchido ÷ total de ofertas encerradas |
Como criar um bom prompt
O Agente de Frete é um aliado estratégico na gestão do ciclo de fretes, mas seu valor depende da forma como você estrutura as perguntas. Um bom prompt aumenta a precisão e a utilidade das respostas.
Um bom prompt deve conter:
- Objetivo claro: o que você deseja saber ou analisar?
- Contexto relevante: qual período, rota, transportadora ou tipo de carga considerar?
- Especificidade: qual nível de detalhe ou formato de resposta é esperado?
Exemplos — Gestor Logístico
Exemplo de prompt mal formulado:
- Como estão os fretes do mês?
Exemplo de prompt melhorado:
- Qual foi o custo total de fretes contratados em abril de 2025 por estado de destino, ordenado do mais caro para o mais barato? Inclua a quantidade de fretes e o custo médio por estado.
Exemplo de prompt mal formulado:
- Quais transportadoras são melhores?
Exemplo de prompt melhorado:
- Liste as 5 transportadoras com maior taxa de sucesso em leilões nos últimos 3 meses, incluindo quantidade de lances vencedores, total de participações e valor médio dos lances vencedores.
Exemplos — Operador Logístico
Exemplo de prompt mal formulado:
- Tem algum frete urgente?
Exemplo de prompt melhorado:
- Quais fretes têm data de coleta nas próximas 24 horas e ainda não foram contratados? Mostre a rota, o valor ideal e quantos lances já foram recebidos.
Exemplo de prompt mal formulado:
- Qual é o frete mais barato?
Exemplo de prompt melhorado:
- Liste os fretes contratados esta semana com rota origem São Paulo/SP → destino Goiânia/GO, ordenados pelo menor lance vencedor. Mostre o nome da transportadora e o desvio em relação ao valor ideal.
Dicas para melhorar seus prompts
- Sempre especifique o período da consulta — use expressões como “último mês”, “esta semana” ou datas exatas para obter resultados precisos.
- Informe o recorte geográfico quando necessário — cidade, estado de origem ou destino ajudam o agente a filtrar os dados corretamente.
- Quando quiser um ranking ou comparativo, diga quantos itens deseja ver e qual critério de ordenação usar (exemplo: “top 5 por menor custo médio”).
- Revise e atualize seus prompts regularmente para garantir relevância e clareza com o contexto operacional atual.
- Compartilhe boas práticas com outros membros da equipe, promovendo padronização e aprendizado coletivo.
- Experimente diferentes formatos de perguntas e refine conforme necessário — o agente suporta tanto perguntas diretas quanto análises comparativas complexas.
Funcionalidades previstas para versões futuras
As capacidades abaixo estão no roadmap do Agente de Frete e não estão disponíveis na versão atual:
- Disparo automático de convites para transportadoras em ofertas sem lance.
- Sugestão automática de valor de lance com base em histórico de rotas similares.
- Alertas proativos via e-mail ou SMS para fretes com risco de não contratação.
- Integração com dados de rastreamento das entregas contratadas.
Referência — Regras de negócio
| Situação | Condição |
|---|---|
| Frete contratado | lance_vencedor preenchido (não NULL) |
| Frete não contratado | data_fim já passada E lance_vencedor é NULL |
| Frete com risco de atraso | data_previsao próxima E lance_vencedor é NULL |
| Frete urgente | data_coleta próxima E lance_vencedor é NULL |
| Economia gerada | valor_sugerido − lance_vencedor (quando lance_vencedor < valor_sugerido) |
| Desvio do ideal | lance_vencedor − valor_ideal (positivo = acima do ideal) |
Critérios de uma oferta fechada
- Tem data de aprovação definida (
data_lanceAprovado). - Tem transportadora atribuída (
nome_transportadoraecnpj_transportadorapreenchidos). - Tem valor do lance definido (
lance_vencedor). - Pode ter data de coleta e previsão (
data_coletaedata_previsaopreenchidas).
Para saber mais sobre a Sara Agentes, entre em contato com seu Executivo de Contas.
Se ainda não for cliente da Senior, clique no botão Solicite uma proposta no topo desta página.
English
Español
