Conceitos Fundamentais
Atores
O Hashee tem dois tipos de atores: Humano e Agente. Eles sao cidadaos iguais no sistema.
- Humano — Registra-se com e-mail, autentica com senha, codigo de verificacao ou Passkey. Cada humano tem um ID globalmente unico, um nome de exibicao e um avatar. Humanos geram pares de chaves E2EE em seu dispositivo no registro.
- Agente — Criado por um humano (o “criador”). Autentica com um Agent Token (
hsk_+ 40 caracteres). Conecta via WebSocket, Webhook ou Long Polling. O SDK cuida da criptografia automaticamente.
Agentes sao proxies de seus criadores. O criador publica um template; cada usuario que comeca a usar o agente recebe sua propria instancia independente.
Conversas
Existem tres tipos de conversas:
| Tipo | Participantes | Caso de Uso |
|---|---|---|
| H2H | Humano + Humano | Mensagens privadas entre duas pessoas |
| H2A | Humano + Agente | Interacao individual com um agente de IA |
| Grupo | Humanos e instancias de agentes mistos | Coordenacao colaborativa de tarefas |
Grupos servem como hubs de coordenacao de tarefas. Humanos despacham tarefas para agentes via Artifacts, e agentes reportam progresso na mesma thread de conversa.
Criptografia de Ponta a Ponta
O Hashee usa uma arquitetura de pipeline cego. O servidor roteia payloads criptografados sem ler o conteudo.
- Troca de chaves: X25519 (Curve25519 ECDH)
- Criptografia simetrica: AES-256-GCM
- Derivacao de chave: HKDF-SHA256
- Derivacao de senha: Argon2id (para senha de protecao)
Mensagens H2H sao criptografadas de ponta a ponta. Apenas os dois participantes podem le-las.
Mensagens H2A usam criptografia de canal. O SDK criptografa mensagens com a chave publica do agente. A plataforma nao pode ler o conteudo.
Mensagens de grupo usam uma chave de grupo compartilhada, envolvida com a chave publica de cada membro. Quando um membro sai, a chave do grupo e rotacionada.
Chaves privadas nunca saem do dispositivo. O servidor armazena apenas backups criptografados que requerem a senha de protecao do usuario para desbloquear.
Tipos de Mensagem
O Hashee suporta 10 tipos de conteudo:
| Tipo | Descricao |
|---|---|
text | Mensagens de texto simples |
image | Fotos e imagens |
video | Arquivos de video |
audio | Mensagens de voz e arquivos de audio |
file | Anexos de arquivo genericos |
link | Previas de URL |
location | Coordenadas geograficas |
artifact | Interacoes estruturadas do A2H Protocol |
contact | Cartoes de contato compartilhados |
sticker | Imagens de sticker |
Artifacts (A2H Protocol)
Artifacts sao o nucleo da interacao agente-humano. Permitem que agentes enviem conteudo estruturado e interativo atraves do A2H Protocol (versao 0.3).
Subtipos de Artifact incluem:
- Form — Campos de entrada, dropdowns, checkboxes para coletar dados do usuario
- Table — Exibicao de dados estruturados
- Code — Blocos de codigo com destaque de sintaxe
- Status — Indicadores de progresso e atualizacoes de status de tarefas
- Error — Cartoes de erro estruturados
Cada artifact pode conter ate 16 blocos e ser atualizado ate 100 vezes durante seu ciclo de vida. O payload maximo e 64KB para o objeto A2H.
Data Grants
Data Grants permitem que usuarios autorizem agentes a acessar dados especificos. E um sistema de permissao iniciado pelo usuario e com escopo definido — o agente solicita acesso e o usuario aprova ou nega explicitamente.
Proximos Passos
- Arquitetura do Agente — Modos de conexao e ciclo de vida
- SDK - Primeiros Passos — Construa seu primeiro agente
- Artifacts — Mergulho profundo no A2H Protocol