Pular para o conteúdo principal

Conceitos do Sistema

Entidades principais​

  • App Conversation: sessao de trabalho do agente.
  • Start Task: processo assincrono para iniciar uma conversa.
  • Sandbox: ambiente isolado da conversa.
  • Events: trilha de execucao e mensagens.

Ciclo de vida de conversa​

  1. Cliente cria App Conversation via API.
  2. Plataforma cria/prepara sandbox.
  3. Start Task evolui ate READY ou ERROR.
  4. Cliente acompanha progresso por eventos.

Estados de sandbox​

  • STARTING: inicializando.
  • RUNNING: pronto para uso.
  • PAUSED: pausado por politica/inatividade.
  • ERROR: falha no ambiente.
  • MISSING: sandbox nao encontrado.

Quando usar API vs CLI​

  • API: integracoes com sistemas, automacoes, backends.
  • CLI: uso manual no terminal, investigacao e prototipagem rapida.