Saltar al contenido
Qomni

Agents

Crea un agente, dale voz y ponlo a atender: REST para las llamadas y un WebSocket para hablar con él en tiempo real desde tu app.

URL base
https://api.qomni.ai/agents/v1
Clave
sk_agents_test_…
curl https://api.qomni.ai/agents/v1/calls \
  -H "Authorization: Bearer sk_agents_test_…"

Novedades

Por qué los datos de cada workspace viven en una celda por país

Qomni guarda los datos de un workspace en su propio país y pone un solo punto de entrada delante. Qué problema resuelve y qué costó.

La grabación de una llamada en Colombia, su transcripción en Brasil y el registro de un agente en Estados Unidos tienen reglas legales distintas. Las tres cosas viven en Qomni. La pregunta de diseño fue dónde guardarlas, y la respuesta define casi todo lo demás: una celda por país.

El problema

Una sola base de datos para todo el mundo es la opción más simple de operar. Obliga a elegir un país para los datos de todos los clientes y a explicar esa elección a cada uno de ellos. Con grabaciones de voz y conversaciones con clientes, esa explicación no siempre convence.

La alternativa habitual es una región por cliente, elegida al registrarse. Pone la decisión en manos de quien menos contexto tiene. Y la hace aparecer en todas partes: en la URL de la API, en la configuración del cliente, en cada SDK.

Lo que hicimos

Cada workspace nace en una celda (us1, co1 o br1): una copia completa de la plataforma en una región. Delante de todas las celdas hay un solo punto de entrada, el edge, un Worker de Cloudflare que recibe cada petición y la lleva a la celda correcta.

sk_agents_live_co1_…token de 10 sTu servidorEdgeCelda co1Celda us1Celda br1

La celda nunca aparece en una URL. Va dentro de la clave de API (sk_agents_live_co1_…), y el edge la lee de ahí sin consultar nada. Para la app web, sale del workspace con el que entraste. Tu código es el mismo para un cliente en Bogotá y para uno en São Paulo.

Lo que costó

  • Un origen no puede confiar en nadie que no sea el edge. Por eso el edge firma cada petición con un token Ed25519. Vale 10 segundos, sirve para una sola petición y va ligado al host, a la celda y a la IP del cliente. Un origen rechaza todo lo que no traiga ese token, así que nadie puede saltarse el edge llamando a una celda directamente.
  • Una clave sólo vale en su celda. Usarla en otra responde 421 wrong_cell. En la práctica no ocurre, porque la celda de la clave es la del workspace que la creó, pero la regla existe para que un error de configuración nunca cruce datos entre países.
  • Los datos no se mueven. Un workspace se queda en su celda. Mover uno sería mover grabaciones de clientes de un país a otro, y preferimos no tener esa herramienta antes que tenerla y usarla mal.

Lo que ganamos

Cumplir las reglas de cada país es una propiedad de la arquitectura, no un proceso. Una petición viaja menos. Y un cliente nunca tiene que elegir una región ni acordarse de ella.

Si quieres ver el recorrido completo de una petición, está en El edge y las celdas.

Recibe un aviso con cada artículo nuevo

Una nota de ingeniería cada vez que publicamos; nada más.

Seguir por RSS
Navegación del sitio

Nuevo

2 de 7 pasos hechosSigue: la plataforma en producción

Qomni está en beta privada

La API y la app todavía no están abiertas. Mira qué está hecho, qué falta y cómo se abre, paso a paso hasta el primer cliente.

Escribe para buscar…

↑↓ moverte↵ abrirEsc para cerrar