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

Usa el SDK de TypeScript

Llama a la API de Agents desde TypeScript o JavaScript con @qomni/sdk: un método por operación, tipos del contrato y errores con código.

@qomni/sdk envuelve cada operación de la referencia en un método con los tipos del contrato: qomni.agents.createCall, qomni.agents.listCalls, qomni.agents.createRealtimeSession y el resto. Se genera desde el contrato, así que un método siempre pide lo que pide la operación.

Antes de empezar

  • Bun, o Node.js 22.18 o superior (los dos ejecutan TypeScript sin compilar).
  • Una clave de prueba de Agents (sk_agents_test_…) en la variable QOMNI_KEY, como en el inicio rápido.
  • El paquete aún no está en npm: instálalo desde la carpeta sdks/typescript/ del repositorio de Qomni.
  1. Instala el paquete

    pnpm add ../qomni/sdks/typescript
  2. Crea el cliente y haz una llamada

    La clave decide el producto y el modo: una clave de Agents sirve en qomni.agents. Guarda el código en call.mts.

    call.mtsts
    import { Qomni, QomniError } from "@qomni/sdk";
    
    const qomni = new Qomni({ apiKey: process.env.QOMNI_KEY! });
    
    try {
      const call = await qomni.agents.createCall(
        { to: "+15005550001" },
        { idempotencyKey: "order-1001" },
      );
      console.log(call.id, call.status);
    } catch (error) {
      if (error instanceof QomniError) {
        console.error(error.status, error.code, error.message);
      } else {
        throw error;
      }
    }
  3. Ejecútalo

    bun run call.mts
    ¿Sin Bun?

    Node.js 22.18 o superior ejecuta el mismo archivo tal cual:

    node call.mts

Deberías ver

Salidatext
call_01hv4k8s2m9q7w3e5r6t8y0u1i completed

El SDK envió POST https://api.qomni.ai/agents/v1/calls con tu clave en Authorization, el cuerpo en JSON y Idempotency-Key: order-1001. En modo de prueba no sonó ningún teléfono: +15005550001 es un número mágico que termina completed. Si la clave no es válida, la API responde 401 y el SDK lanza un QomniError con el code del error, por ejemplo api_key_malformed.

Siguientes pasos

  • Cada método se llama como su operación en la referencia de Agents: parámetros de ruta, luego el cuerpo, luego la query, luego las opciones (idempotencyKey, signal, headers). El ejemplo en TypeScript de cada operación ya usa el SDK.
  • Habla con un agente en tiempo real: createRealtimeSession abre la conversación.
  • Errores: los códigos que puede traer un QomniError.
  • Idempotencia: cuándo mandar idempotencyKey.
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