Assistela Assistela Documentação
Configuração da Assistela

Seu próprio provedor de LLM

Conecte sua conta de um provedor de LLM com uma chave de API ou use o início de sessão de uma assinatura do ChatGPT.

Antes de começar

Para uma conexão por API, você precisa de uma conta no provedor escolhido e da respectiva chave de API. Uma assinatura do ChatGPT e a API da OpenAI são serviços diferentes: o ChatGPT Plus, por si só, não cria uma chave de API da OpenAI nem oferece créditos de API.

Armazenamento seguro

Quando a Assistela perguntar onde deve armazenar senhas e chaves de acesso, escolha Usar as Chaves do Mac para o uso comum. É mais fácil fazer backup dos Dados da Assistela, mas esses dados ficam mais confidenciais quando contêm chaves.

OpenAI, Anthropic ou outro provedor da lista

1

Adicione uma conta de IA

Abra Assistela → Ajustes → Contas de IA. Clique em + no canto inferior esquerdo e escolha seu provedor.

2

Verifique o servidor de API

Nos provedores da lista, o endereço do servidor de API na aba Conta já vem preenchido. Não o altere, a menos que o provedor informe expressamente outro endereço.

3

Cole a chave de API

Em Chave de acesso, cole a chave de API exatamente como ela aparece no painel do provedor. Não acrescente espaços nem aspas.

4

Salve e verifique

Clique em Salvar e verificar conta. Aguarde uma mensagem informando que a conta está pronta ou que a conexão está funcionando.

5

Selecione um modelo

Abra a aba Modelo. Mantenha o modelo predefinido ou atualize a lista de modelos e escolha outro. Insira manualmente o nome de um modelo somente se o provedor não o retornar na lista.

6

Defina-a como padrão

Na aba Conta, clique em Definir como padrão. Depois, envie uma mensagem de teste no Chat.

API personalizada compatível com OpenAI ou Anthropic

No menu +, escolha Personalizada compatível com OpenAI ou Personalizada compatível com Anthropic. O endereço do servidor não vem preenchido em uma conta personalizada.

  • Em Endereço do servidor de API, insira a URL completa indicada na documentação do provedor. Uma API compatível com OpenAI geralmente inclui um caminho como /v1, mas a documentação específica do provedor é a fonte oficial.
  • Confirme o formato correto da conexão: formato da API da OpenAI ou formato da API Messages da Anthropic.
  • Cole a chave de API e clique em Salvar e verificar conta.
  • Na aba Modelo, carregue a lista de modelos. Se a API não fornecer uma lista, escolha um modelo personalizado e insira o ID exato do modelo.

Assinatura do ChatGPT sem chave de API

1

Escolha Assinatura do ChatGPT

Em Ajustes → Contas de IA, clique em + e escolha Assinatura do ChatGPT.

2

Inicie a conexão

Clique em Conectar ChatGPT. A Assistela exibirá um código de uso único.

3

Abra a OpenAI

Use Abrir página da OpenAI e Copiar código. Na página aberta, inicie uma sessão na conta correta do ChatGPT e insira o código.

4

Aguarde a confirmação

Volte à Assistela e mantenha a janela aberta. O aplicativo verificará a conexão automaticamente durante vários minutos. Se aparecer um botão para confirmar que você inseriu o código, use-o.

5

Defina-a como padrão

Quando a conexão for concluída, clique em Definir como padrão e teste o Chat.

Problemas comuns

  • Chave inválida: crie ou copie a chave de API novamente e salve a conta outra vez.
  • Endereço do servidor de API inválido: confira https://, o caminho da API e qualquer /v1 no final com a documentação do provedor.
  • Modelo não encontrado: atualize a lista de modelos ou insira o ID exato do modelo.
  • A conta funciona, mas o Chat não a utiliza: defina a conta como padrão e confirme que ela está ativada.

Como escolher um modelo sem ajustes complexos

Para a conta principal, comece com um modelo que, segundo o provedor, seja compatível com tool calling. Se o Chat responder, mas não conseguir usar a Agenda, o e-mail ou outras ações, verifique a compatibilidade com tool calling antes de alterar os ajustes avançados de tokens.

  • Use um modelo geral competente como padrão para o Chat e trabalhos complexos.
  • Um modelo rápido e mais econômico pode ser adequado para verificações automáticas simples e frequentes.
  • Depois de alterar o modelo, use Salvar e verificar conta e teste uma ação segura, somente de leitura.

Consulte Roteamento de modelos para distribuir o trabalho entre vários modelos.