Perfis
Perfis são configurações salvas para modelos de IA. Cada perfil armazena uma configuração completa -- provedor, modelo, prompt do sistema, temperatura, persona e mais -- que você pode alternar instantaneamente. Perfis também são os blocos de construção para conselhos.
Perfis Individuais vs Conselhos
O AISCouncil distingue entre dois tipos de perfis:
| Tipo | Membros | Uso |
|---|---|---|
| Perfil Individual | 1 modelo | Chat padrão de modelo único |
| Conselho | 2+ modelos | Deliberação multi-modelo (veja Conselho de LLM) |
Um perfil com um membro é um perfil individual. Adicione um segundo membro e ele automaticamente se torna um conselho. A plataforma detecta isso baseado em members.length >= 2.
Criando Perfis
Há várias maneiras de criar um perfil:
1. Assistente de Configuração (Novos Usuários)
Quando você abre o AISCouncil pela primeira vez sem perfis existentes, o assistente guia você através da criação do seu primeiro perfil:
- Caminho Perfil Único: Escolha um modelo, conecte sua chave de API, defina um nome e ícone
- Caminho Cluster: Selecione múltiplos modelos para criar um conselho
2. Botão Novo Bot
Clique no botão + ou Novo Chat na barra lateral esquerda para criar um novo bot. Configure-o no painel direito, e ele é salvo como perfil automaticamente.
3. Importar de JSON
Importe perfis de um arquivo JSON:
- Abra Configurações > Perfil
- Clique no botão Importar
- Selecione um arquivo
.jsoncontendo um ou mais perfis
O formato de importação aceita um único objeto de perfil ou um array de perfis. Novos IDs são sempre atribuídos para evitar conflitos com perfis existentes.
Campos de Perfil
Cada perfil armazena a seguinte configuração:
Configurações Principais
| Campo | Descrição | Padrão |
|---|---|---|
| Nome | Nome de exibição do perfil | "Untitled" |
| Provedor | Provedor de IA (anthropic, openai, xai, gemini, openrouter, ollama) | anthropic |
| Modelo | ID do modelo específico | -- |
| Prompt do Sistema | Instruções que definem o comportamento do bot | Vazio |
| Temperatura | Controla aleatoriedade (0 = determinístico, 2 = criativo) | 0.7 |
| Máx. Tokens | Comprimento máximo de saída por resposta | 4096 |
Configurações de Persona
| Campo | Descrição |
|---|---|
| Ícone | Emoji ou caractere exibido ao lado do nome do bot e respostas |
| Descrição | Descrição curta do que este bot faz |
| Cor | Cor de destaque para bolhas de mensagem de usuário no chat deste bot |
Configurações Avançadas
| Campo | Descrição | Padrão |
|---|---|---|
| Top P | Limiar de amostragem de núcleo | 1.0 |
| Penalidade de Frequência | Penaliza repetição de tokens | 0 |
| Penalidade de Presença | Encoraja diversidade de tópicos | 0 |
| Sequências de Parada | Tokens separados por vírgula onde geração para | Vazio |
| Formato de Resposta | Modo de saída de texto ou JSON | text |
| Esforço de Raciocínio | Nível de pensamento/raciocínio (veja Pensamento) | Padrão |
| Seed | Seed fixo para saídas reproduzíveis | Nenhum |
Configurações de Chat
| Campo | Descrição | Padrão |
|---|---|---|
| Limite de Contexto | Máx. mensagens enviadas por solicitação | Ilimitado |
| Streaming | Streaming de token em tempo real | Ligado |
| Auto-título | Definir título do chat automaticamente a partir da primeira mensagem | Desligado |
| Renderização Markdown | Renderizar respostas como markdown | Ligado |
| Mostrar Contagem de Tokens | Exibir uso de tokens | Desligado |
Chave de API Por Bot
Cada perfil pode armazenar sua própria chave de API que substitui a chave global para aquele provedor. Isso é útil quando você tem múltiplas chaves para o mesmo provedor (ex: diferentes contas de cobrança) ou quando compartilha uma configuração de perfil onde diferentes usuários trazem suas próprias chaves.
Chaves de API por bot são armazenadas na configuração do perfil. Elas são incluídas em exportações de perfil completas mas nunca são incluídas em URLs de bots compartilhados ou exportações seguras.
Alternando Entre Perfis
Clique em qualquer bot na barra lateral esquerda para alternar para ele. A área de chat carrega o histórico de conversa daquele bot, e o painel de configuração atualiza para mostrar suas configurações.
Ao alternar:
- A configuração do bot atual é salva (com debounce)
- O histórico de chat do novo bot é carregado do IndexedDB
- O painel de configuração é populado com as configurações do novo bot
- Se o novo bot tem um stream em segundo plano ainda executando, é reanexado
Editando Configurações de Perfil
O painel de configuração direito é sempre editável para o bot ativo. Mudanças são salvas automaticamente com um debounce de 300ms -- apenas edite e as configurações persistem.
Para acessar o editor de perfil completo:
- Abra Configurações > Perfil
- Selecione o perfil para editar
- Modifique qualquer campo: nome, membros, prompt do sistema, temperatura, configurações avançadas
- Mudanças salvam automaticamente
Importando e Exportando Perfis
Exportação
Dois modos de exportação estão disponíveis:
| Modo | Chaves de API | Caso de Uso |
|---|---|---|
| Exportação Segura | Removidas (membros apenas têm provedor + modelo) | Compartilhando com outros |
| Exportação Completa | Incluídas | Backup pessoal, transferência entre dispositivos |
Exporte de Configurações > Perfil > Exportar. O arquivo é um array JSON de objetos de perfil.
Importação
Importação aceita:
- Um único objeto de perfil:
{ "name": "...", "members": [...], ... } - Um array de perfis:
[{ "name": "...", ... }, { "name": "...", ... }]
Na importação:
- Novos IDs únicos são atribuídos a cada perfil (sem colisões)
- Timestamps são definidos para o tempo de importação
- Os perfis são adicionados à sua lista existente (não substituindo)
Perfis importados são aditivos. Eles não sobrescrevem ou substituem seus perfis existentes.
Menu Suspenso de Perfil em Conselhos
Ao construir um conselho, membros são selecionados via menu suspenso de perfil -- não escolhendo um provedor e modelo inline. Isso significa:
- Crie perfis individuais primeiro (um por modelo que você quer no conselho)
- No construtor de conselho, adicione membros selecionando do menu suspenso de perfil
- Cada membro do conselho referencia um perfil por ID
Este design permite reutilizar o mesmo perfil em múltiplos conselhos e garante que mudanças em um perfil (como atualizar a chave de API) propagam automaticamente para todos os conselhos que o referenciam.
Resolução de Perfil
Quando uma mensagem é enviada, a plataforma resolve a configuração do perfil nesta ordem:
- Chave de API por bot (armazenada na configuração de membro do perfil)
- Referência de perfil (se o membro referencia outro perfil por ID)
- Perfil correspondente ao provedor (escaneia todos os perfis por um provedor correspondente com uma chave)
- Chave de API global (de
localStorage['ais-apikey-{provider}'])
Esta resolução em cascata garante que chaves de API sejam sempre encontradas se existirem em qualquer lugar no sistema.
Excluindo um Perfil
Para excluir um perfil:
- Na barra lateral esquerda, passe o mouse sobre o bot que deseja excluir
- Clique no botão excluir (ícone de lixeira)
- Confirme a exclusão no diálogo
Excluir um perfil remove o bot, seu histórico de chat e suas memórias. Esta ação não pode ser desfeita. Conselhos que referenciam o perfil excluído terão aquele membro removido.
Armazenamento de Perfil
| Propriedade | Detalhe |
|---|---|
| Backend | IndexedDB (chave: ais-profiles) com backup de sincronização localStorage |
| Persistência | Sobrevive recarregamentos de página e reinicializações de navegador |
| Escopo | Local no seu navegador |
| Exportação | Incluído em backup "Exportar Todos os Dados" |
| URLs Compartilhados | Config de bot (não o perfil completo) é codificada em URLs compartilhados |