Настройка ClineCore для приватной работы с кодом

Настройте сеанс до отправки конфиденциального кода

ClineCore позволяет приложению создать среду выполнения и запускать сеансы с настройками модели и среды выполнения. При принятии решений о конфиденциальности важно учитывать не только выбор провайдера, но и то, какие данные получает сеанс, какие инструменты могут с ними работать и что приложение сохраняет или раскрывает впоследствии.

Приведённые ниже примеры иллюстративные и не являются проверенными интеграциями. В справке ClineCore описана структура API, но не подтверждается, что каждый провайдер принимает одни и те же параметры модели или настройки конечной точки. Прежде чем полагаться на специфичные для провайдера параметры, сверьтесь с его документацией.

Разделяйте общие настройки и настройки сеанса

Параметры ClineCore.create охватывают такие настройки, как имя клиента, режим серверной части, политики инструментов, возможности и включение автоматизации. Для вызова start требуется config с настройками модели и среды выполнения сеанса. В документированном примере указаны providerId, modelId, apiKey, systemPrompt, cwd, workspaceRoot, а также флаги инструментов и агента.

Минимальный вариант для серверной части может выглядеть так:

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,
  },
})

В этом примере используются переменные окружения как способ работы с учётными данными; справка не предписывает использовать менеджер секретов и не определяет названия этих переменных окружения. Храните ключ на доверенном сервере, не передавайте его в код браузера и не выводите конфигурацию сеанса в журналы приложения. Если провайдеру требуется конечная точка или дополнительные параметры, задавайте их только в соответствии с его документацией и убедитесь, что ClineCore поддерживает нужные поля.

Принимайте решения о конфиденциальности осознанно

Перед запуском сеанса определите, что именно нужно агенту. Если задача это позволяет, ограничьте рабочую область или передавайте только выбранные файлы вместо всего репозитория. Не включайте в материалы для агента секреты, персональные данные и файлы, не относящиеся к задаче. Системный промпт может описывать требования к обработке данных, но не заменяет контроль доступа и минимизацию данных.

Не менее тщательно проверяйте доступ к инструментам. ClineCore принимает политики инструментов по умолчанию и для отдельных сеансов; возможности среды выполнения могут включать исполнители инструментов, принадлежащие клиенту, и функции обратного вызова для подтверждения действий. Отключайте инструменты, если они не нужны для задачи; если без них не обойтись, выбирайте политики и процедуры подтверждения с учётом возможных последствий. В справке описаны эти точки настройки, но не определено поведение каждого инструмента и не гарантируется, что конкретная политика предотвратит все действия с конфиденциальными данными.

Считайте записи сеансов потенциально чувствительными. API позволяет получать список сеансов, запрашивать метаданные и сообщения, читать накопленные данные об использовании, обновлять записи и удалять сеансы. Поэтому приложение должно определить, кому разрешено вызывать эти методы и какие правила хранения применяются. Не помещайте секреты и ненужные персональные данные в sessionMetadata, начальные сообщения или промпты: метаданные и сообщения — это данные сеанса, а не защищённое хранилище секретов.

Параметр distinctId описан как стабильный идентификатор пользователя или телеметрии. Если вы его используете, подумайте, действительно ли приложению нужен постоянный идентификатор и не позволит ли он установить личность человека. В справке не объясняются сбор телеметрии, сроки хранения или анонимизация, поэтому не считайте этот идентификатор анонимным и не полагайте, что его настройка управляет всей телеметрией.

Устранение распространённых проблем настройки

• При создании сеанса конфигурация отклоняется: проверьте, что config указан, а идентификаторы провайдера и модели соответствуют допустимым значениям провайдера. В приведённой справке дан пример, а не полный перечень провайдеров.
• Не проходит аутентификация: убедитесь, что ключ доступен серверному процессу, относится к выбранному провайдеру и не был случайно обрезан или заменён. Никогда не вставляйте ключ в диагностический промпт или обращение в службу поддержки.
• Специфичный для провайдера параметр игнорируется или отклоняется: справка ClineCore не описывает универсальную совместимость конечных точек и параметров. Сверьтесь с документацией провайдера и SDK, а не предполагайте, что настройки одного провайдера подойдут другому.
• Сеанс может выполнять больше действий, чем нужно: проверьте enableTools, политики инструментов и переданные возможности. Если инструменты не нужны, сначала отключите их, а затем включайте только необходимые для рабочего процесса.
• В истории появляются конфиденциальные данные: проверьте, какие части приложения вызывают readMessages, list и связанные API сеансов, затем настройте соответствующие меры авторизации и хранения. В справке описаны эти API, но не меры защиты хранилища и доступа в вашем приложении.
• Работа неожиданно продолжается: используйте документированный метод abort или stop для сеанса и освобождайте ресурсы среды выполнения, когда приложение завершило работу с ними.

Повторно используемый контрольный список перед запуском

Перед включением рабочего процесса ClineCore убедитесь, что учётные данные остаются на сервере; в рабочей области находятся только необходимые файлы; в промптах и метаданных нет секретов; доступ к инструментам ограничен и проверен; для истории сеансов определены ответственный и срок хранения; специфичные для провайдера параметры сверены с актуальной документацией. Для отладки записывайте несекретные сведения, например, был ли запущен сеанс и какой внутренний идентификатор запроса к нему относится. Не записывайте учётные данные, полные промпты или исходные файлы.

Справка ClineCore описывает средства настройки и управления сеансами, но не даёт безусловной гарантии конфиденциальности. Защита данных зависит от того, как приложение передаёт данные, ограничивает доступ к инструментам, защищает записи сеансов и обрабатывает учётные данные.

Источник

• Справочник API ClineCore — параметры API, конфигурация сеансов, методы управления сеансами и обзор автоматизации.