Pular para o conteúdo
Qomni

Agents

Crie um agente, dê voz a ele e coloque-o para atender: REST para as ligações e um WebSocket para falar com ele em tempo real a partir do seu app.

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

Novidades

Use o SDK de TypeScript

Chame a API do Agents a partir de TypeScript ou JavaScript com @qomni/sdk: um método por operação, tipos do contrato e erros com código.

@qomni/sdk envolve cada operação da referência em um método com os tipos do contrato: qomni.agents.createCall, qomni.agents.listCalls, qomni.agents.createRealtimeSession e o restante. É gerado a partir do contrato, então um método sempre pede o que a operação pede.

Antes de começar

  • Bun, ou Node.js 22.18 ou superior (os dois executam TypeScript sem compilar).
  • Uma chave de teste do Agents (sk_agents_test_…) na variável QOMNI_KEY, como no início rápido.
  • O pacote ainda não está no npm: instale-o a partir da pasta sdks/typescript/ do repositório do Qomni.
  1. Instale o pacote

    pnpm add ../qomni/sdks/typescript
  2. Crie o cliente e faça uma chamada

    A chave decide o produto e o modo: uma chave do Agents serve em qomni.agents. Salve o código em 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. Execute

    bun run call.mts
    Sem Bun?

    Node.js 22.18 ou superior executa o mesmo arquivo sem alterações:

    node call.mts

Você deve ver

Salidatext
call_01hv4k8s2m9q7w3e5r6t8y0u1i completed

O SDK enviou POST https://api.qomni.ai/agents/v1/calls com sua chave em Authorization, o corpo em JSON e Idempotency-Key: order-1001. Em modo de teste nenhum telefone tocou: +15005550001 é um número mágico que termina completed. Se a chave não for válida, a API responde 401 e o SDK lança um QomniError com o code do erro, por exemplo api_key_malformed.

Próximos passos

  • Cada método tem o nome da sua operação na referência do Agents: parâmetros de caminho, depois o corpo, depois a query, depois as opções (idempotencyKey, signal, headers). O exemplo em TypeScript de cada operação já usa o SDK.
  • Fale com um agente em tempo real: createRealtimeSession abre a conversa.
  • Erros: os códigos que um QomniError pode trazer.
  • Idempotência: quando enviar idempotencyKey.
Navegação do site

Novo

2 de 7 passos feitosA seguir: a plataforma em produção

A Qomni está em beta privada

A API e o app ainda não estão abertos. Veja o que está feito, o que falta e como abre, passo a passo até o primeiro cliente.

Digite para buscar…

↑↓ mover↵ abrirEsc para fechar