VALIDATA Developers

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#

  1. El modelo decide cuándo llamar a la herramienta validar_pedido y le pasa los datos del pedido.
  2. Tu servicio (Cloud Run, Cloud Functions…) recibe esa llamada, construye la solicitud, la firma con el secreto y llama a VALIDATA.
  3. Tu servicio devuelve al modelo solo next_action y el texto que debe usar.
  4. El secreto vive en Secret Manager y se monta en tu servicio; el modelo nunca lo ve.
Definición de herramienta (ejemplo)
{
  "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.