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

Por que os dados de cada workspace vivem em uma célula por país

O Qomni guarda os dados de um workspace no seu próprio país e põe um único ponto de entrada na frente. Que problema resolve e o que custou.

A gravação de uma chamada na Colômbia, sua transcrição no Brasil e o registro de um agente nos Estados Unidos têm regras legais distintas. As três coisas vivem no Qomni. A pergunta de design foi onde guardá-las, e a resposta define quase tudo o mais: uma célula por país.

O problema

Um único banco de dados para o mundo todo é a opção mais simples de operar. Obriga a escolher um país para os dados de todos os clientes e a explicar essa escolha a cada um deles. Com gravações de voz e conversas com clientes, essa explicação nem sempre convence.

A alternativa habitual é uma região por cliente, escolhida no cadastro. Põe a decisão nas mãos de quem tem menos contexto. E a faz aparecer em todo lugar: na URL da API, na configuração do cliente, em cada SDK.

O que fizemos

Cada workspace nasce em uma célula (us1, co1 ou br1): uma cópia completa da plataforma em uma região. Na frente de todas as células há um único ponto de entrada, o edge, um Worker da Cloudflare que recebe cada requisição e a leva à célula correta.

sk_agents_live_co1_…token de 10 sSeu servidorEdgeCélula co1Célula us1Célula br1

A célula nunca aparece em uma URL. Vai dentro da chave de API (sk_agents_live_co1_…), e o edge a lê dali sem consultar nada. Para o app web, sai do workspace com o qual você entrou. Seu código é o mesmo para um cliente em Bogotá e para um em São Paulo.

O que custou

  • Uma origem não pode confiar em ninguém além do edge. Por isso o edge assina cada requisição com um token Ed25519. Vale 10 segundos, serve para uma única requisição e fica ligado ao host, à célula e ao IP do cliente. Uma origem rejeita tudo o que não traga esse token, então ninguém consegue pular o edge chamando uma célula diretamente.
  • Uma chave só vale na sua célula. Usá-la em outra responde 421 wrong_cell. Na prática não acontece, porque a célula da chave é a do workspace que a criou, mas a regra existe para que um erro de configuração nunca cruze dados entre países.
  • Os dados não se movem. Um workspace fica na sua célula. Mover um seria mover gravações de clientes de um país para outro, e preferimos não ter essa ferramenta a tê-la e usá-la mal.

O que ganhamos

Cumprir as regras de cada país é uma propriedade da arquitetura, não um processo. Uma requisição viaja menos. E um cliente nunca precisa escolher uma região nem lembrar dela.

Se você quer ver o percurso completo de uma requisição, está em O edge e as células.

Receba um aviso a cada artigo novo

Uma nota de engenharia a cada publicação; nada mais.

Seguir por RSS
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