Playground

Teste rascunhos — inclusive edições não salvas — com payloads reais, leia a confiança e as distribuições, pré-visualize destinos, compare execuções e engines e repita entradas de execuções anteriores.

O Playground roda o rascunho de uma decisão sobre um estado que você fornece e mostra tudo o que a API devolveria, mais as distribuições completas. Use-o para iterar nas instruções e nas descrições das opções antes de publicar.

Abra-o pela aba Playground de uma decisão, ou por Playground na barra lateral, escolhendo a decisão ali. Nessa página, uma decisão cujo slug é o id de um template — como lead-qualification — começa com o estado de exemplo do template.

O que ele roda

O Playground roda o rascunho, nunca a versão publicada. Na aba Playground da decisão, ele roda até as edições que você ainda não salvou, e fica bloqueado enquanto o rascunho tem problemas de schema; a página Playground da barra lateral roda o último rascunho salvo. Quando a decisão está no ar, o cabeçalho lembra que a produção continua na versão ativa.

Rode um estado

  1. Escreva o estado em JSON. Para um estado de objeto, um objeto; para um estado de texto, uma string JSON como "Hi, I'd like pricing for 50 seats."; para um estado de lista, um array como ["Hi!", "We're a team of 50 and want pricing."].
  2. Use Exemplo para gerar um estado a partir do state schema e Formatar para indentá-lo. O editor mostra o tamanho em bytes e se o JSON é válido.
  3. Para campos image, audio e file, anexe os arquivos em Arquivos — ou clique em Gravar num campo de áudio para gravar uma mensagem de voz. Eles entram no estado na hora de rodar; veja Entradas.
  4. Clique em Rodar decisão ou pressione ⌘/Ctrl + Enter.

Leia o resultado

  • O result tipado, o selo da ação e o motivo em palavras simples — A regra de política #1 casou, "route" respondeu "other" (nenhuma opção serve), Confiança de "route" 52% < 80%, Engine indisponível (ENGINE_TIMEOUT); fallback aplicado ou Nenhuma regra casou.
  • Uma barra de confiança por pergunta. Expanda-a para ver a distribuição entre todas as opções ou níveis — e, para uma pergunta de nota, o nível ponderado (1 = primeiro nível), o número com que as regras de nível ponderado comparam. Perguntas com um quase empate ou abaixo da confiança mínima abrem automaticamente.
  • Um card Compostos com o valor de cada composite.
  • Latência, modelo, custo estimado com os tokens de entrada e um link para a execução.

Quando o engine falha numa decisão com onEngineError: "fallback", um aviso diz que a decisão respondeu com a ação de fallback e que a chamada não é cobrada.

Destinos

Para decisões com destinos, o resultado termina com um card Destinos. Por padrão, ele é uma pré-visualização e nada sai da Dcision: respostas fixas são renderizadas, destinos LLM mostram o prompt que enviariam, e webhooks, requisições de API, workflows e agentes mostram a requisição exata — com os segredos mascarados como ••••.

Ligue Executar destinos de verdade, ao lado de Rodar decisão, para chamar os LLMs e agentes e enviar as entregas, marcadas com livemode: false. O card então acompanha cada entrega — enviando, tentando de novo, entregue ou falhou — e oferece Reenviar nas falhas. Veja Testando destinos.

Compare execuções

A partir da segunda execução, Comparado com a execução anterior lista cada resposta e a ação antes e depois, destacando o que mudou — o jeito mais rápido de ver o efeito de uma instrução ou descrição de opção reescrita.

Compare os engines

Comparar motores, ao lado de Rodar decisão, roda o mesmo estado e o mesmo rascunho no Jev, no Laya e no OpenAI Decisions de uma vez. O card Motores lado a lado então mostra, por engine:

  • a resposta de cada pergunta com a sua confiança;
  • a ação;
  • a latência e o custo estimado;
  • o código de erro quando aquele engine falhou — ENGINE_NOT_CONFIGURED para um engine que o workspace não configurou em Configurações → Engine.

As linhas em que os engines discordam ficam destacadas. Conta como três execuções do Playground, cada uma registrada em Execuções, e os destinos nunca são entregues — nem com Executar destinos de verdade ligado. Para comparar engines no tráfego de produção, use o modo sombra; veja Compare e rode engines em sombra.

Repita entradas anteriores

Em Execuções, abra uma execução e clique em Rodar esta entrada de novo no Playground: o estado guardado é carregado no Playground dessa decisão, pronto para rodar contra o rascunho atual. É um teste de regressão rápido depois de uma edição.

Repetir exige a entrada guardada, então não está disponível para execuções de decisões com storeInput desligado.

Trechos de código

Abaixo do resultado, o Playground mostra a mesma chamada em cURL, TypeScript e Python para o estado atual. Eles apontam para o endpoint publicado, então funcionam depois que a decisão for publicada e você tiver uma API key.

Limites e custo

  • As execuções do Playground não são cobradas em nenhum plano e não consomem o seu volume mensal.
  • Elas rodam com as configurações de engine do seu workspace: com a sua própria chave de provedor, o provedor as cobra.
  • Até 30 execuções por minuto e 2.000 execuções por dia por workspace; acima disso você recebe 429 RATE_LIMITED — use uma API key para volume.
  • Toda execução fica registrada em Execuções com origem Playground e versão rascunho.
  • Rodar o Playground exige o papel de Membro ou superior: Leitores podem abri-lo, mas não rodá-lo — veja Time, papéis e conta.

Nesta página