Simple Agent
Criar meu agente
Docstraining

Reindexação e Atualização

Quando e como forçar a reindexação de fontes para manter seu agent atualizado.

O Simple Agent mantém seu agent atualizado automaticamente, mas há situações onde você precisa forçar uma reindexação manual.

Atualização automática

Por padrão, cada fonte tem um ciclo de atualização:

Tipo de fonte Frequência padrão
URL / Site A cada 7 dias
Sitemap A cada 3 dias
PDF Sem atualização automática (estático)
Texto direto Sem atualização automática (estático)

A atualização automática é executada em segundo plano — seu agent não fica offline durante o processo.

Quando forçar reindexação manual

Reindexe manualmente quando:

  • Você atualizou o conteúdo do site e não quer esperar 7 dias
  • Corrigiu um erro em um PDF e fez novo upload
  • O agent está dando respostas desatualizadas
  • Adicionou novas páginas ao sitemap

Como reindexar

  1. No painel do agent → aba Treinamento
  2. Clique nos três pontos ao lado da fonte
  3. Selecione Reindexar agora

O status muda para Indexando... e retorna a Ativo quando concluído. Para sites grandes (100+ páginas), pode levar de 2 a 10 minutos.

Via API

POST /v1/sources/{source_id}/reindex

curl -X POST https://simple-agent.me/api/v1/sources/src_xxxx/reindex \
  -H "Authorization: Bearer af_live_xxxx"

Resposta:

{
  "id": "src_xxxx",
  "status": "indexing",
  "started_at": "2026-05-14T10:30:00Z"
}

Para checar o status:

GET /v1/sources/{source_id}

# Resposta quando concluído:
{
  "id": "src_xxxx",
  "status": "active",
  "chunks_count": 342,
  "last_indexed_at": "2026-05-14T10:32:18Z"
}

Webhook de atualização automática

Se você tem um pipeline de publicação de conteúdo (CMS, GitHub Actions, etc.), pode disparar a reindexação via webhook após cada publicação:

# No seu pipeline de deploy
curl -X POST https://simple-agent.me/api/v1/sources/src_xxxx/reindex \
  -H "Authorization: Bearer af_live_xxxx"

Isso garante que o agent está sempre sincronizado com seu conteúdo publicado.

Excluir e recriar vs reindexar

Use reindexar quando:

  • O conteúdo foi atualizado na mesma URL
  • Você quer manter o histórico de chunks

Exclua e recrie quando:

  • A estrutura do site mudou drasticamente
  • Você quer fazer uma limpeza total dos embeddings antigos
  • Mudou o tipo de fonte (ex: substituiu PDF por URL)

Limites de reindexação

Plano Reindexações manuais/mês
Starter 10 por agent
Growth 50 por agent
Agency Ilimitado

Reindexações automáticas agendadas não contam para o limite.

Monitorar qualidade após reindexação

Após reindexar, acesse o Playground e teste as mesmas perguntas que revelaram respostas desatualizadas. Se o problema persistir, use Ver chunks para confirmar que o conteúdo correto foi indexado.

Se o novo conteúdo não aparecer, verifique:

  • Se a página não bloqueia crawlers via robots.txt ou meta tag noindex
  • Se o conteúdo é gerado via JavaScript (nosso crawler usa headless, mas algumas SPAs com carregamento tardio podem precisar de ajuste)

Fontes de treinamento → · API Reference →