> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ascn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Секреты и ключи

> Безопасное хранение токенов и API-ключей для внешних сервисов.

**Секреты** — это переменные окружения для безопасного хранения токенов, API-ключей и других учётных данных. Агент использует их при обращении к внешним сервисам, и они никогда не отображаются в открытом виде.

<img src="https://mintcdn.com/ascn-b377dab5/dZwp8NTeHyd0j5bJ/images/16-secrets.png?fit=max&auto=format&n=dZwp8NTeHyd0j5bJ&q=85&s=2c988b4aa0991a33378b42acfd415b19" alt="Раздел Настройки → Секреты и ключи" width="2681" height="1252" data-path="images/16-secrets.png" />

## Когда нужны секреты

Секреты нужны, если вы подключаете собственные API или сервисы, которые требуют ключей авторизации. Например:

* API-ключ стороннего сервиса
* Токен корпоративного Slack или другого инструмента
* Ключи для вебхуков и интеграций

<Info>
  Стандартные коннекторы (Gmail, Google Calendar, Slack и др.) авторизуются через OAuth — секреты для них добавлять не нужно.
</Info>

## Как добавить секрет

1. Откройте **Настройки → Секреты и ключи**
2. Нажмите **+ Добавить секрет**
3. Введите **название** (например, `API_KEY`) и **значение** — токен или ключ
4. Сохраните

## Как использовать секрет

После добавления секрет доступен агенту как переменная окружения по его названию. Укажите название в описании задачи или скилла:

```
При обращении к API используй ключ из переменной MY_API_KEY.
```

## Безопасность

* Значения секретов зашифрованы и не отображаются в интерфейсе после сохранения
* Секреты не попадают в историю чатов и логи
* Удалить секрет можно в любой момент через **Настройки → Секреты и ключи**