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

O que uma chave de API do Qomni carrega dentro

O formato das chaves sk_produto_modo_celula e o que cada parte poupa ao edge, ao cliente e ao suporte.

Uma chave de API parece uma cadeia aleatória, mas a do Qomni conta uma história: sk_agents_live_co1_8fK2…Qa91Zx. Cada parte está ali por uma razão concreta, e as razões são o tema desta nota.

O produto, na chave

Cada produto do Qomni tem sua API, seu consumo e sua fatura. Uma chave vale para um único produto. Com uma chave do Agents você pode chamar api.qomni.ai/agents/v1 e nada mais; em outra API falha com 401 api_key_wrong_product.

É uma decisão de superfície de ataque. Um sistema que cria chamadas recebe uma chave do Agents e, se essa chave vazar, o atacante não entra no app web nem na conta. E revogar uma chave não toca nas demais.

O modo, na chave

live ou test não é uma configuração da conta: quem decide é a chave. Uma chave de teste trabalha sobre dados separados, não disca nenhum número e não fatura. O código é o mesmo; muda uma variável de ambiente. Assim, o que você testa é exatamente o que vai rodar em produção.

A célula, para não consultar nada

co1 diz onde vivem os dados do workspace. O edge lê esse prefixo e envia a requisição à célula correta sem buscar em nenhum banco de dados. É a razão pela qual a URL da API nunca carrega região.

O checksum, para falhar cedo

Os últimos seis caracteres são um CRC32 do restante, em base62. Uma chave mal copiada é rejeitada no edge, com 401 api_key_malformed, antes de chegar a qualquer servidor. O suporte reconhece esse erro sem olhar mais nada.

O que não está na chave

O Qomni guarda só o hash SHA-256 de cada chave. Por isso a chave completa é mostrada uma única vez, ao criá-la, e depois só se veem seu prefixo e seus últimos quatro caracteres. Uma chave perdida não se recupera: cria-se outra e revoga-se a anterior.

sk_agents_live_co1_8fK2…Qa91Zxsk: secretaagents: produtolive: modoco1: célula30 caracteres: segredo6 caracteres: checksum

E os limites

Cada chave tem seu próprio orçamento: 120 requisições por minuto. As requisições rejeitadas com 401 são contadas à parte, por endereço IP, para que um cliente mal configurado não esgote o orçamento das chaves válidas da mesma rede.

A anatomia completa está em Chaves de API e autenticação.

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