Testando destinos

Veja prévias dos destinos no Playground com os segredos mascarados, execute-os de verdade com livemode false, use API keys de teste e acompanhe entregas, tentativas e respostas dos receptores.

Prévias no Playground

O Playground roda o rascunho e, por padrão, só mostra prévias dos destinos — nada é chamado nem enviado:

TipoA prévia mostra
Resposta fixaA resposta, renderizada como um balão de chat com os botões.
LLMO prompt que seria enviado: provedor, modelo, o prompt e a mensagem renderizados. O modelo não é chamado.
Webhook, requisição de API, workflow, agenteA requisição exata — método, URL, headers e body — com todo segredo exibido como ••••.
FunçãoA chamada que o seu código faria, como assignToSales({ "email": "ana@acme.com" }).
Entradas de prévia
[
  {
    "key": "sales_llm",
    "type": "llm",
    "status": "preview",
    "prompt": {
      "provider": "openrouter",
      "model": "openai/gpt-5-mini",
      "instructions": "You are Acme's sales team. Answer the lead in two sentences, say that a person will follow up today and never quote prices.",
      "input": "We need pricing for 500 users and want to start next month."
    }
  },
  {
    "key": "create_lead",
    "type": "http",
    "status": "preview",
    "request": {
      "method": "POST",
      "url": "https://api.crm.example.com/v2/leads?source=lead-qualification",
      "headers": { "authorization": "Bearer ••••", "content-type": "application/json" },
      "body": "{\"email\": \"ana@acme.com\", \"score\": 0.8414, \"note\": \"Routed to sales by Dcision\"}"
    }
  }
]

As prévias usam a mesma renderização das execuções reais, então são o lugar para conferir URLs, codificações e bodies JSON antes que qualquer coisa saia da Dcision. Os headers da própria Dcision — a assinatura, o ID da entrega — são adicionados quando uma requisição é enviada de verdade.

Executar destinos de verdade

Quando a decisão tem destinos, o Playground mostra Executar destinos de verdade ao lado de Rodar decisão. Ligue-o e as próximas execuções:

  • chamam modelos de LLM e agentes no modo sync, e mostram as respostas deles;
  • enviam webhooks, requisições de API, workflows e repasses a agentes async, com as novas tentativas de sempre;
  • marcam tudo como teste: livemode é false nos eventos de webhook, no objeto dcision de um workflow e no objeto decision de um agente, e o app rotula as entregas como modo de teste.

As execuções do Playground não são cobradas — um provedor de LLM continua cobrando os tokens na sua chave — e contam para os limites do Playground de 30 execuções por minuto e 2.000 por dia. No Playground, decision.version é null: ele roda o rascunho.

API keys de teste

Chamadas feitas com uma chave de teste (dcs_test_…) rodam a versão publicada e entregam de verdade, com livemode: false. Use-as para staging e CI contra receptores de staging. Elas são cobradas como chamadas live — veja Chaves live e de teste.

Os receptores devem checar a flag e manter eventos de teste fora dos sistemas de produção. Requisições de API não trazem o campo livemode — aponte-as para uma URL de staging enquanto testa.

Acompanhe o que aconteceu

  • O card Destinos do Playground atualiza cada entrega enquanto ela roda: enviando, tentando de novo, entregue ou falhou, as tentativas, o status HTTP e a latência, a próxima tentativa e o erro do receptor. Reenviar tenta de novo uma entrega com falha.
  • Execuções mostra o mesmo card para toda execução, inclusive as feitas pela API.
  • A Visão geral da decisão conta respostas devolvidas, entregas feitas, com falha e pendentes, por destino.
  • O dcision validate da CLI lista os destinos de um schema, e dcision decide --json imprime os destinations de uma resposta.

Antes de entrar em produção

Veja a prévia dos destinos no Playground com alguns estados reais — um por rota — e confira cada URL, header e body.

Execute-os de verdade contra receptores de staging: verifique a assinatura, deduplique pelo ID da entrega e ignore ou roteie os eventos com livemode: false.

Publique, chame o endpoint com uma chave de teste e depois troque a sua integração para uma chave live. Acompanhe a Visão geral da decisão para ver destinos com falha.

Nesta página