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:
| Tipo | A prévia mostra |
|---|---|
| Resposta fixa | A resposta, renderizada como um balão de chat com os botões. |
| LLM | O prompt que seria enviado: provedor, modelo, o prompt e a mensagem renderizados. O modelo não é chamado. |
| Webhook, requisição de API, workflow, agente | A requisição exata — método, URL, headers e body — com todo segredo exibido como ••••. |
| Função | A chamada que o seu código faria, como assignToSales({ "email": "ana@acme.com" }). |
[
{
"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éfalsenos eventos de webhook, no objetodcisionde um workflow e no objetodecisionde 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 validateda CLI lista os destinos de um schema, edcision decide --jsonimprime osdestinationsde 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.
Entrega e retries
Como a Dcision entrega webhooks, requisições de API, workflows e repasses a agentes — pelo menos uma vez, seis tentativas em cerca de sete horas, Retry-After, timeouts, status, reenvios e retenção.
Segurança e limites dos destinos
Como a Dcision protege as requisições de saída — só https, proteção contra SSRF, sem redirecionamentos, segredos — o que cada tipo envia e guarda, quem configura o quê, e todos os limites.