SofiCode

A Sofi, assistente de inteligência artificial da Findes, dentro do VS Code. Converse com ela no
Chat ou peça ao Agente de código que leia o projeto, proponha alterações e rode comandos. Nada
muda nos seus arquivos sem a sua aprovação.
Para quem é: colaboradores com acesso à Sofi (sofi.findes.org.br). Quem está na lista de uso da
SofiCode usa tudo; os demais usam a Sofi Web: o Chat da Sofi dentro do VS Code, sem o Agente de código.

O que ela faz
- Agente de código: lê arquivos, procura no projeto, edita trechos e executa comandos no terminal.
Cada edição aparece com o diff, e cada comando espera a sua aprovação.
- /brainstorm: antes de pedir ao Agente, pense a ideia com a Sofi. Ela pergunta, critica e sugere, sem
alterar nada, e fecha com uma descrição pronta, que vai ao Agente de código com um clique.
- Comandos com "/": digite / no campo para ver a lista (planejar, revisar, compactar, OneDrive...).
- Chat: a mesma Sofi da web, com histórico de conversas, anexos de imagem e PDF e arquivos do OneDrive.
- Agentes da Sofi: converse com os agentes especializados, os seus e os compartilhados com você.
- Arquivos gerados: quando a Sofi cria um arquivo no Chat, o botão Baixar abre a janela "Salvar como".
- Modelos: Claude Sonnet 4.6 (padrão do Agente), Claude Haiku 4.5, GPT-6.1 Sol, GPT-6 Luna,
GPT-5.4 Mini e Nano. No Chat também há o Kimi K2.6. A lista acompanha o que a Sofi oferece.
- Modos de permissão: pedir aprovação a cada ação, editar sem perguntar ou só planejar. Comandos
perigosos sempre pedem confirmação.
- Desfazer o turno: um clique volta os arquivos ao estado de antes da última resposta.
- Fontes de dados: Obsidian e Notion, e outros servidores MCP configurados no projeto.

Primeiro uso
Ao abrir o painel (ícone da Sofi na barra lateral), a tela inicial guia você nesta ordem:
- Seu e-mail da Findes: a SofiCode confere se você está na lista de uso. Fora dela, você pode usar a
Sofi Web (o Chat no VS Code) ou abrir a Sofi no navegador.
- Esta máquina: conexão com a Sofi, navegador para o login (Edge ou Chrome já instalados), Python
(pode ser instalado pelo próprio painel ou dispensado), Node.js (opcional) e uma pasta aberta.
- Login na Sofi: abre uma janela do navegador para você entrar com a conta Microsoft. A extensão não
vê nem guarda sua senha. Depois do login, a permissão é conferida pela sua conta da Sofi.
Com tudo marcado, clique em Iniciar uso.


Configurações avançadas
Pelo ⚙️ do painel ou pelo comando SofiCode: Configurações avançadas: ligue e desligue recursos, indique
o caminho de um programa, baixe o Node portátil e escolha as fontes de dados.

Comandos
| Comando |
O que faz |
| SofiCode: Abrir Chat |
Abre o painel da Sofi |
| SofiCode: Nova Conversa |
Começa uma conversa nova |
| SofiCode: Entrar na Sofi |
Faz o login com a conta Microsoft |
| SofiCode: Sair |
Encerra a sessão; opcionalmente, esquece a conta guardada no navegador de login |
| SofiCode: Explicar Seleção |
Pede à Sofi que explique o trecho selecionado |
| SofiCode: Adicionar Seleção ao Chat |
Leva o trecho selecionado para a conversa |
| SofiCode: Inicializar projeto |
Cria AGENTS.md, README.md e SUMARIO-DIARIO.md que faltarem |
| SofiCode: Configurações avançadas |
Abre o painel de recursos e fontes de dados |
Privacidade e segurança
- As mensagens vão só para a Sofi da Findes. A extensão não usa outro provedor de IA.
- A sessão fica no cofre de segredos do VS Code. Em máquina compartilhada, use Sair e esquecer a conta.
- O Agente só altera arquivos e roda comandos com a sua aprovação, ou no modo que você escolher.
- Programas encontrados numa pasta de projeto só são usados se você confiar nessa pasta (Workspace Trust).
Requisitos
- VS Code 1.85 ou superior, no Windows (macOS e Linux sem teste completo).
- Conta Microsoft da Findes com acesso à Sofi e liberada na lista de uso da SofiCode.
- Microsoft Edge ou Google Chrome. Sem eles, o painel oferece baixar o navegador de login (cerca de 300 MB).
Suporte
Dúvidas e pedidos de acesso: rededemercado@findes.org.br.
| |