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

Qué lleva dentro una clave de API de Qomni

El formato de las claves sk_producto_modo_celda y lo que cada parte le ahorra al edge, al cliente y a soporte.

Una clave de API parece una cadena aleatoria, pero la de Qomni cuenta una historia: sk_agents_live_co1_8fK2…Qa91Zx. Cada parte está ahí por una razón concreta, y las razones son el tema de esta nota.

El producto, en la clave

Cada producto de Qomni tiene su API, su consumo y su factura. Una clave vale para un solo producto. Con una clave de Agents puedes llamar a api.qomni.ai/agents/v1 y a nada más; en otra API falla con 401 api_key_wrong_product.

Es una decisión de superficie de ataque. Un sistema que crea llamadas recibe una clave de Agents y, si esa clave se filtra, el atacante no entra a la app web ni a la cuenta. Y revocar una clave no toca a las demás.

El modo, en la clave

live o test no es un ajuste de la cuenta: lo decide la clave. Una clave de prueba trabaja sobre datos separados, no marca ningún número y no factura. El código es el mismo; cambia una variable de entorno. Así, lo que pruebas es exactamente lo que va a correr en producción.

La celda, para no consultar nada

co1 dice dónde viven los datos del workspace. El edge lee ese prefijo y envía la petición a la celda correcta sin buscar en ninguna base de datos. Es la razón por la que la URL de la API nunca lleva región.

El checksum, para fallar temprano

Los últimos seis caracteres son un CRC32 del resto, en base62. Una clave mal copiada se rechaza en el edge, con 401 api_key_malformed, antes de llegar a ningún servidor. Soporte reconoce ese error sin mirar nada más.

Lo que no está en la clave

Qomni guarda sólo el hash SHA-256 de cada clave. Por eso la clave completa se muestra una sola vez, al crearla, y después sólo se ven su prefijo y sus últimos cuatro caracteres. Una clave perdida no se recupera: se crea otra y se revoca la anterior.

sk_agents_live_co1_8fK2…Qa91Zxsk: secretaagents: productolive: modoco1: celda30 caracteres: secreto6 caracteres: checksum

Y los límites

Cada clave tiene su propio presupuesto: 120 peticiones por minuto. Las peticiones rechazadas con 401 se cuentan aparte, por dirección IP, para que un cliente mal configurado no agote el presupuesto de las claves válidas de la misma red.

La anatomía completa está en API keys y autenticación.

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