Integraciones · Contrato listo · Sin entorno
Agentes de IA en Google Cloud
Si tu agente de ventas corre en Google Cloud (Cloud Run, Vertex AI u otro), conecta VALIDATA como una herramienta HTTP que ejecuta tu código, no el modelo.
Arquitectura recomendada#
- El modelo decide cuándo llamar a la herramienta
validar_pedidoy le pasa los datos del pedido. - Tu servicio (Cloud Run, Cloud Functions…) recibe esa llamada, construye la solicitud, la firma con el secreto y llama a VALIDATA.
- Tu servicio devuelve al modelo solo
next_actiony el texto que debe usar. - El secreto vive en Secret Manager y se monta en tu servicio; el modelo nunca lo ve.
{
"name": "validar_pedido",
"description": "Valida un pedido contraentrega y devuelve la acción siguiente. Obedece siempre next_action.",
"input_schema": {
"type": "object",
"required": ["external_order_ref", "phone", "city", "department", "address_line", "total"],
"properties": {
"external_order_ref": { "type": "string" },
"phone": { "type": "string" },
"department": { "type": "string" },
"city": { "type": "string" },
"address_line": { "type": "string" },
"total": { "type": "string", "description": "Decimal como texto, p. ej. 120000" }
}
}
}La herramienta devuelve al modelo, por ejemplo: { "next_action": "OFFER_FREIGHT_ADVANCE" }. Para el resto de reglas, ver buenas prácticas para agentes de IA.
Reintentos#
Deriva la Idempotency-Key del pedido (no del turno de la conversación) y guárdala junto con event_at, para que un reintento del agente envíe exactamente lo mismo. Limita los reintentos del agente: la herramienta, no el modelo, aplica la política de Idempotencia.