Configure o ClineCore para sessões de programação com foco em privacidade

Configure a sessão antes de enviar código privado

O ClineCore permite que um aplicativo crie um runtime e inicie sessões com configurações de modelo e runtime. A decisão prática sobre privacidade não se resume a escolher um provedor: também envolve os dados recebidos pela sessão, as ferramentas que podem atuar sobre eles e o que o aplicativo persiste ou expõe depois.

Os exemplos abaixo são ilustrativos, não integrações testadas. A referência do ClineCore documenta o formato da API, mas não confirma que todos os provedores aceitem os mesmos parâmetros de modelo ou configurações de endpoint. Consulte a documentação do seu provedor antes de depender de opções específicas dele.

Separe as configurações compartilhadas das configurações da sessão

As opções de ClineCore.create abrangem escolhas como o nome do cliente, o modo de backend, as políticas de ferramentas, os recursos e a ativação da automação. A chamada start exige um config com as configurações de modelo e runtime da sessão. O exemplo documentado inclui providerId, modelId, apiKey, systemPrompt, cwd, workspaceRoot e flags de ferramentas e agentes.

Um padrão mínimo no servidor é:

import { ClineCore } from "@cline/sdk"

const cline = await ClineCore.create({
  clientName: "private-code-review",
  backendMode: "auto",
  toolPolicies: {
    // Set policies for the tools your application exposes.
  },
})

const session = await cline.start({
  prompt: "Review the selected files for risky input handling.",
  config: {
    providerId: process.env.CLINE_PROVIDER_ID!,
    modelId: process.env.CLINE_MODEL_ID!,
    apiKey: process.env.CLINE_API_KEY!,
    systemPrompt: "Review only the supplied code. Do not request secrets.",
    cwd: process.cwd(),
    workspaceRoot: process.cwd(),
    enableTools: false,
    enableSpawnAgent: false,
    enableAgentTeams: false,
  },
})

Este exemplo usa variáveis de ambiente como prática para lidar com credenciais; a referência não exige um gerenciador de segredos nem define os nomes dessas variáveis de ambiente. Mantenha a chave em um servidor confiável, não a envie para o código do navegador e evite registrar a configuração da sessão nos logs do aplicativo. Se o provedor exigir um endpoint ou parâmetros adicionais, configure-os somente conforme a documentação dele e confirme que o ClineCore oferece suporte aos campos necessários.

Tome decisões de privacidade de forma explícita

Antes de iniciar uma sessão, decida do que o agente precisa. Quando a tarefa permitir, prefira um workspace restrito ou arquivos selecionados em vez do repositório inteiro. Exclua do material fornecido ao agente segredos, dados pessoais e arquivos sem relação com a tarefa. Um prompt de sistema pode especificar expectativas de tratamento, mas não substitui controles de acesso nem a minimização de dados.

Revise o acesso às ferramentas com o mesmo cuidado dedicado ao conteúdo dos prompts. O ClineCore aceita políticas de ferramentas padrão e por sessão, e os recursos do runtime podem incluir executores de ferramentas controlados pelo cliente e callbacks de aprovação. Mantenha as ferramentas desativadas quando a tarefa não precisar delas; quando forem necessárias, use políticas e aprovações adequadas aos efeitos que podem produzir. A referência documenta esses pontos de configuração, mas não define o comportamento de cada ferramenta nem garante que uma política específica impeça todas as ações confidenciais.

Trate os registros da sessão como potencialmente confidenciais. A API pode listar sessões, recuperar metadados e mensagens, consultar o uso acumulado, atualizar registros e excluir sessões. Por isso, seu aplicativo deve definir quem pode chamar esses métodos e quais regras de retenção se aplicam. Evite incluir segredos ou dados pessoais desnecessários em sessionMetadata, nas mensagens iniciais ou nos prompts: metadados e mensagens são dados da sessão, não um armazenamento seguro de segredos.

A opção distinctId é descrita como um identificador estável de telemetria/usuário. Se usá-la, avalie se o aplicativo precisa de um identificador estável e se ele pode identificar uma pessoa. A referência não explica a coleta de telemetria, a retenção nem a anonimização; portanto, não presuma que o identificador seja anônimo ou que defini-lo controle toda a telemetria.

Resolva problemas comuns de configuração

• A criação da sessão rejeita a configuração: Confirme que config está presente e que os identificadores do provedor e do modelo correspondem aos valores aceitos pelo provedor. A referência fornecida traz um exemplo, não um catálogo completo de provedores.
• A autenticação falha: Verifique se a chave está disponível no processo do servidor, corresponde ao provedor selecionado e não foi cortada ou substituída por engano. Nunca inclua a chave em um prompt de diagnóstico nem a cole em um chamado de suporte.
• Uma opção específica do provedor é ignorada ou rejeitada: A referência do ClineCore não documenta compatibilidade universal de endpoints ou parâmetros. Consulte a documentação do provedor e do SDK, em vez de presumir que as configurações de um provedor sirvam para outro.
• Uma sessão consegue executar mais ações do que deveria: Revise enableTools, as políticas de ferramentas e os recursos fornecidos. Comece com as ferramentas desativadas quando não forem necessárias e ative apenas as exigidas pelo fluxo de trabalho.
• Conteúdo confidencial aparece no histórico: Verifique quais caminhos do aplicativo chamam readMessages, list e APIs de sessão relacionadas; em seguida, aplique controles de autorização e retenção adequados. A referência disponibiliza essas APIs, mas não especifica as proteções de armazenamento ou acesso do seu aplicativo.
• O trabalho continua inesperadamente: Use o método documentado abort ou stop para a sessão e libere os recursos do runtime quando o aplicativo terminar de usá-los.

Checklist reutilizável antes de iniciar

Antes de ativar um fluxo de trabalho do ClineCore, confirme que a credencial permanece no servidor; o workspace contém apenas os arquivos necessários; prompts e metadados não incluem segredos; o acesso às ferramentas é limitado e revisado; o histórico da sessão tem um responsável e uma política de retenção; e as configurações específicas do provedor foram verificadas na documentação atualizada dele. Para depurar, registre informações não confidenciais, como se uma sessão foi iniciada e qual ID de solicitação interno se aplica — não credenciais, prompts completos ou arquivos-fonte.

A referência do ClineCore oferece recursos de configuração e gerenciamento de sessões, não uma garantia geral de privacidade. A operação com foco em privacidade depende de como o aplicativo fornece dados, controla o acesso às ferramentas, protege os registros das sessões e lida com credenciais.

Fonte

• Referência da API do ClineCore — opções da API, configuração de sessões, métodos de gerenciamento de sessões e visão geral da automação.