Como começar a usar o Jev

Comece sem programar

Você pode testar seu texto e sua pergunta na demo gratuita e independente deste site sem fornecer uma chave de API. Defina uma regra de Sim/Não ou 2 a 6 opções. Para conectar o Jev ao seu aplicativo, siga o caminho oficial de acesso à conta e à API da TypeSafe, explicado separadamente abaixo.

A demo permite até 10.000 caracteres no total entre texto, pergunta, regras e opções, contados como pontos de código Unicode. Esse é o limite do site, não a janela de contexto do Jev. Verificações ao vivo podem exigir verificação humana e ser pausadas nos limites de uso ou orçamento. Carregar um modelo de tarefa não o executa nem fornece um resultado do modelo.

Abrir o editor personalizado · Carregar o modelo de classificação de feedback

1. Comece pelo caminho de acesso adequado

Em 17 de setembro de 2026, o site público da TypeSafe apresenta uma lista de espera. O guia rápido oficial fornece instruções para o Playground e a API. Uma página de documentação acessível não significa que toda conta tenha acesso ao modelo.

• Se você não tem acesso: use a lista de espera no site oficial da TypeSafe. Este site não pode aprovar contas nem emitir chaves de API.
• Se sua conta tem acesso: abra o console da TypeSafe e siga o fluxo do Playground ou de criação de chave de API.

A disponibilidade de contas e o processo de entrada podem mudar. O console oficial é o lugar para verificar a situação da sua conta.

2. Experimente uma pergunta específica

No Playground, use uma mensagem fictícia curta como entrada e faça uma pergunta Noul. Por exemplo, use uma mensagem pedindo uma ligação de retorno e pergunte se há um pedido explícito de retorno por telefone. Depois, mude a entrada para um pedido vago de ajuda e observe se o resultado muda.

Esse é um exercício de exploração, não um teste de acurácia. Começar com dois exemplos contrastantes ajuda a perceber se sua pergunta descreve a distinção que você pretendia fazer.

O Jev chama as informações fornecidas de state, ou estado. Elas podem ser uma string, um objeto JSON ou um array. Para tarefas mais elaboradas, use campos nomeados para distinguir a mensagem, os registros de apoio e a política relevante. Formatos de entrada

curl --fail-with-body --silent --show-error \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "jev-latest",
  "state": "Please call me tomorrow morning to discuss the setup.",
  "questions": {
    "callback_requested": {
      "type": "noul",
      "instructions": "Does the sender explicitly ask for a phone call?"
    }
  }
}
JSON

4. Acrescente estrutura apenas quando a tarefa exigir

Use Choice quando o próximo passo depender de uma categoria, Score quando houver níveis ordenados com significado claro e Noul quando precisar de uma probabilidade de sim ou não. Agrupe perguntas independentes sobre o mesmo estado; trate os resultados na sua aplicação.

Como próximo passo concreto, siga o exemplo de chamado de suporte. Ele mostra como uma saída documentada se transforma em uma proposta de encaminhamento.

5. Investigue o acesso e a requisição separadamente

Se o login no console não for concluído, reabra o console oficial pelo ponto de entrada habitual e confirme que está usando a conta com acesso. Evite alterar repetidamente a requisição de API para resolver um problema de login no navegador. Um login bem-sucedido também não comprova que uma chave de API foi emitida. Se precisar de ajuda com a conta, use o canal oficial de suporte da TypeSafe; nunca inclua uma chave ou um link de login em um relato público.

Para uma requisição HTTP, examine o status e o corpo do erro antes de mudar a pergunta:

Esses códigos estão documentados na referência da API. Para 429 ou 529, use espera exponencial entre tentativas. As configurações padrão dos SDKs já incluem novas tentativas; leve essas tentativas em conta antes de acrescentar um laço externo de repetição.

Um tempo limite excedido é diferente de uma resposta negativa. Defina um prazo total e um número limitado de tentativas e, então, encaminhe o trabalho não resolvido para revisão. Garanta que repetir a requisição ao modelo não possa repetir uma ação posterior, como criar uma atribuição.

6. Investigue uma resposta inesperada

Esses são passos de investigação propostos pela equipe editorial. O guia de Score explica os valores fracionários; nossa página de limitações traz links para as ressalvas atuais do fornecedor e as observações da comunidade, identificadas separadamente.

O alias jev-latest pode passar a apontar para um modelo mais novo. Registre o identificador do modelo retornado durante os testes; quando a reprodutibilidade importar, use um identificador com versão aceito pela sua conta. Aliases de modelos

7. Decida se o primeiro fluxo está pronto

Antes de habilitar ações automáticas, mantenha um pequeno conjunto de decisões esperadas, revise os erros e escolha limiares para o seu fluxo. Use a calculadora de preços para estimar o gasto com tokens de entrada e o guia de comparação para decidir o que deve continuar a cargo de outras ferramentas.