Agentes

Entrega un resultado a tu propio endpoint de agente con las instrucciones y herramientas de la ruta — espera su respuesta en la respuesta, o delega en segundo plano con reintentos.

Un destino agent llama a un endpoint que tú operas — tu agente de soporte, un servicio con LangGraph o Agents SDK, un asistente interno — con el estado, las instrucciones de la ruta y las herramientas que puede usar en esa ruta. Dcision decide qué agente y con qué encargo; tu agente hace el trabajo.

modeQué pasaEn la respuesta
sync (por defecto)Dcision llama al agente mientras quien llama espera y extrae su respuesta."status": "completed" con reply, o "status": "failed" con error.
asyncUna delegación: la solicitud se pone en cola y se entrega en segundo plano, con reintentos."status": "queued" con delivery_id.

Configúralo

{
  "key": "shipping_agent",
  "type": "agent",
  "when": { "conditions": [{ "field": "department", "on": "output", "operator": "eq", "value": "shipping" }] },
  "params": { "awb": { "from": "state.awb", "required": true } },
  "agent": {
    "url": "https://agents.example.com/support",
    "headers": [{ "name": "Authorization", "value": "Bearer {{secrets.AGENT_TOKEN}}" }],
    "instructions": "Help with the shipment {{params.awb}}. Confirm the address before rescheduling.",
    "tools": ["track_package", "reschedule_delivery"],
    "mode": "sync",
    "replyPath": "data.answer",
    "timeoutMs": 20000
  }
}
CampoTipoPor defectoDescripción
urlstring—Tu endpoint: https://…, o {{secrets.NAME}} con la URL completa. Hasta 2,048 caracteres, con variables.
headersarray[]Hasta 20 pares { "name", "value" }; valores de hasta 2,048 caracteres, con variables y secretos.
instructionsstring—El prompt de la ruta, enviado como instructions: hasta 32,000 caracteres — espacio para todo un playbook — con variables, sin secretos.
toolsarray[]Hasta 50 nombres de herramientas que tu agente conoce — letras, dígitos y _ . : -, hasta 64 caracteres cada uno.
modestringsyncsync o async.
replyPathstring—Solo sync: dónde está la respuesta en el JSON que devuelve el agente, como una ruta con puntos como data.answer.
timeoutMsinteger20000De 1,000 a 25,000 — solo sync.

La solicitud que recibe tu agente

POST /support HTTP/1.1
Host: agents.example.com
Content-Type: application/json
Authorization: Bearer agt_live_51Hq…
User-Agent: Dcision-Destinations/1.0 (+https://docs.dcision.io/destinations)
Dcision-Delivery: dlv_Hq2Lm9Xc4Rv1Tz8Wn3Bk
Dcision-Attempt: 1
Dcision-Event: decision.completed
Dcision-Signature: t=1759658400,v1=6f1c2b…
Idempotency-Key: dlv_Hq2Lm9Xc4Rv1Tz8Wn3Bk
Body
{
  "input": { "message": "Where is my package? It was due yesterday.", "awb": "4471-2210" },
  "instructions": "Help with the shipment 4471-2210. Confirm the address before rescheduling.",
  "tools": ["track_package", "reschedule_delivery"],
  "params": { "awb": "4471-2210" },
  "decision": {
    "decision": "support-desk",
    "decision_id": "dec_7Wq2Lm9Xc4Rv1Tz8Wn3B",
    "version": 2,
    "execution_id": "exec_Vn4Kp8Wd2Lq6Tz1Xc9Bs",
    "result": { "department": "shipping", "urgency": "medium" },
    "confidence": { "department": 0.92, "urgency": 0.71 },
    "action": "continue",
    "action_reason": { "type": "default" },
    "destination": "shipping_agent",
    "delivery_id": "dlv_Hq2Lm9Xc4Rv1Tz8Wn3Bk",
    "livemode": true
  }
}
CampoDescripción
inputEl estado completo, tal como lo envió quien llama.
instructionsEl prompt de la ruta con sus variables completadas; null cuando el destino no tiene.
toolsLos nombres de las herramientas de la ruta.
paramsLos params del destino.
decisionLo que respondió la decisión — slug e IDs, version (null en el Playground), result, confidence, action, action_reason — además de la clave del destino, el delivery_id y livemode (false para claves de prueba y el Playground).

La solicitud va firmada como un webhook: verifica Dcision-Signature sobre el body sin procesar con verifySignature — el body es una solicitud de agente, no un evento de webhook. En modo async, deduplica por Idempotency-Key, el ID de la entrega, que se mantiene igual en cada intento.

La respuesta que Dcision espera

En modo sync, responde 2xx dentro de timeoutMs. Dcision toma la respuesta de:

  1. el campo en replyPath, cuando defines uno;
  2. si no, el primero de estos campos de nivel superior que exista: reply, output_text, output, text, message, content;
  3. o el body completo, cuando la respuesta no es JSON.

Un string se usa tal cual; los demás valores se devuelven como texto JSON.

En la respuesta
{
  "key": "shipping_agent",
  "type": "agent",
  "status": "completed",
  "reply": "Your package is at the local depot. I can deliver it tomorrow between 9 and 12 — shall I book it?",
  "response": { "data": { "answer": "Your package is at the local depot. I can deliver it tomorrow between 9 and 12 — shall I book it?", "session": "s_9f2c" } }
}

response es la respuesta completa del agente, parseada cuando es JSON, y null cuando supera los 16,000 caracteres. reply es null cuando no se encontró ningún campo de respuesta — define Campo de respuesta (replyPath) en el destino.

Una llamada sync se hace una sola vez: sin reintentos, las redirecciones no se siguen y la respuesta se lee hasta 64 KB. Cualquier otra cosa se convierte en una entrada fallida, y la decisión igual responde:

{ "key": "shipping_agent", "type": "agent", "status": "failed", "error": "The agent answered 503. upstream overloaded" }

Los fallos incluyen una respuesta que no es 2xx (con el inicio de su body), un timeout, un error de red, una dirección que no es pública y un secreto faltante.

Quien llama espera a los agentes sync, en paralelo con las respuestas de LLM; como máximo se ejecutan 3 por ejecución.

Delegaciones (async)

Con "mode": "async", la misma solicitud firmada se pone en cola y se entrega con el calendario de reintentos de los webhooks — seis intentos a lo largo de unas siete horas, de 10 segundos cada uno. Solo importa el estado de tu respuesta: responde 2xx una vez que hayas aceptado la tarea y continúa el trabajo por tu lado.

Un endpoint de agente mínimo

import express from "express";
import { DcisionError, verifySignature } from "@dcision/sdk";

const app = express();

// The raw body: the signature covers the exact bytes Dcision sent.
app.post("/support", express.raw({ type: "application/json" }), async (req, res) => {
  try {
    await verifySignature(req.body, req.header("dcision-signature"), process.env.DCISION_WEBHOOK_SECRET!);
  } catch (error) {
    return res.sendStatus(error instanceof DcisionError ? 400 : 500);
  }
  const task = JSON.parse(req.body.toString("utf8"));
  const reply = await supportAgent.run({
    input: task.input,
    instructions: task.instructions,
    tools: task.tools,
    conversationId: task.decision.execution_id,
  });
  res.json({ reply });
});

Los ejemplos usan los SDKs, que se compilan desde el código fuente hasta que se publiquen.

Datos

Un agente recibe el estado completo como input, además de los params que mapees. En el Playground, las vistas previas muestran la solicitud exacta — con los secretos enmascarados — sin llamar a tu agente.

En esta página