# Обучите Atlas на базе знаний

> Настройте источники, поддерживайте точность ответов и безопасно подключите Claude Code или Codex для поиска и управления базой знаний TicketCord.

## Что Atlas умеет усваивать

Источники добавляются в настройках базы знаний в дашборде. Их три:

- **Отдельная страница.** Укажите Atlas URL, и он обойдёт страницу (и несколько настраиваемых уровней вглубь). Лучше всего для справочных статей, FAQ и продуктовых страниц, которые вы уже ведёте на своём сайте.
- **Канал Discord.** Импортируйте историю сообщений из канала Discord - полезно, когда команда поддержки уже отвечала на те же вопросы публично и вы хотите, чтобы Atlas учился на этих ответах.
- **Репозиторий GitHub.** Привяжите репозиторий и необязательный путь; Atlas индексирует все найденные там Markdown-файлы (`.md`, `.mdx`). Хорошо для инженерных команд, которые держат документацию рядом с кодом.

## Структурирование записей

Небольшие сфокусированные источники работают лучше одной гигантской страницы. Из справочного центра с отдельной статьёй на каждую тему («Политика возвратов», «Отмены», «Доступность по регионам») Atlas извлекает чистые ответы гораздо проще, чем из одного мега-документа «Всё, что нужно знать». Atlas цитирует использованный источник в ответе, так что гранулярные источники делают и цитаты полезнее.

## Обучение прямо из ответов команды

Когда сотрудник исправляет черновик Atlas перед отправкой, исправление фиксируется как запись «вопрос-ответ» и добавляется в базу знаний. Дальше оно конкурирует с остальными источниками на следующем похожем вопросе - с ранжированием по релевантности и голосам сообщества - так что хорошие исправления со временем поднимаются сами. Никакого переобучения запускать не нужно; новые записи доступны для поиска сразу.

## Чего добавлять не стоит

- Секреты, пароли, API-ключи, данные клиентов.
- Устаревшие политики. Atlas считает каждую запись актуальной.
- Заметки по длительным инцидентам. Для них лучше подходят шаблоны ответов.

## Контроль качества

Время от времени открывайте список базы знаний в дашборде и просматривайте его на предмет устаревших записей. Если ответ изменился (цены, политика, поддерживаемый регион), отредактируйте или удалите запись, чтобы Atlas перестал цитировать устаревшую версию. После крупных изменений документации переобходите записи на основе URL, чтобы индекс отражал то, что клиенты реально найдут на вашем сайте.

## Управляйте базой знаний с помощью ИИ-инструментов

**MCP** представляет собой защищённое соединение, которое позволяет Claude Code или Codex работать с базой знаний TicketCord после входа и подтверждения доступа. Вы можете давать задания обычным языком вместо перехода по каждому экрану дашборда.

## Перед подключением

- Вы должны быть владельцем учётной записи TicketCord. Сотрудники с доступом к дашборду не могут создавать MCP-подключение.
- Ваш активный тариф должен включать доступ к базе знаний.
- Установите Claude Code или Codex CLI и убедитесь, что можете войти в TicketCord.
- Одно подключение может получить доступ ко всем серверам, которыми вы владеете сейчас или добавите позже. Каждый запрос всё равно указывает одного бота и сервер, а TicketCord заново проверяет владельца и тариф при каждом запросе.

## Подключите Claude Code или Codex

1. В дашборде выберите бота и сервер. Откройте **База знаний > Конфигурация** и найдите **Подключить ИИ-инструменты**.
2. Для Claude Code выполните `claude mcp add --transport http ticketcord https://ticketcord.com/api/mcp --scope user`, затем `claude mcp login ticketcord`.
3. Для Codex выполните `codex mcp add ticketcord --url https://ticketcord.com/api/mcp`, затем `codex mcp login ticketcord`.
4. TicketCord откроется в браузере. Войдите, прочитайте предупреждение о доступе ко всей учётной записи и запрашиваемых правах на чтение, запись и удаление. Затем выберите **Разрешить доступ** или **Отказать**.
5. Когда появится сообщение **Аутентификация завершена**, закройте вкладку и вернитесь к ИИ-инструменту. Попробуйте: `Покажи мои базы знаний TicketCord.`

## Что можно попросить сделать

- Показать базы знаний и проверить настройки, источники, состояние индексации и записи.
- Искать по смыслу и возвращать короткие подходящие фрагменты с названиями источников и уровнем уверенности.
- Добавлять, редактировать, включать, отключать, переиндексировать или удалять веб-страницы, каналы Discord и уже подключённые источники GitHub.
- Создавать и редактировать записи, проверять ожидающие записи и одобрять, отклонять или удалять их.
- Обновлять доступные в дашборде настройки сведений о продукте, триггеров, отображения, качества, обновлений, поведения, обратной связи, обучения на тикетах и Auto Support.

## Полезные примеры запросов

- `Покажи мои базы знаний и укажи, в каких нет готовых источников.`
- `Найди нашу политику возврата средств и сделай краткое резюме с названиями источников.`
- `Найди записи со старыми ценами. Сначала покажи их и ничего не меняй.`
- `Добавь https://docs.example.com как источник документации и запусти индексацию.`
- `Покажи ожидающие записи и перед изменениями порекомендуй одобрить или отклонить их.`
- `Покажи текущий ответ о сбросе пароля, а затем помоги его обновить.`

## Права, безопасность и доступ

- Доступ на чтение позволяет просматривать и искать знания. Запись позволяет менять настройки, источники и записи. Удаление позволяет навсегда удалять источники и записи.
- Для рискованных изменений попросите ИИ-инструмент сначала показать найденные данные и объяснить запланированное действие.
- Удаление необратимо. TicketCord заново проверяет ваши права при каждом запросе, даже после одобрения подключения.
- Если тариф закончится или потеряет доступ к базе знаний, подключение будет приостановлено. Оно может заработать после перехода на подходящий тариф, если вы его не отозвали и срок доступа для продления не истёк.
- Немедленно отзовите подключение с карточки **Подключить ИИ-инструменты** в настройках базы знаний.
- Подключение и отключение учётной записи GitHub по-прежнему выполняется только в дашборде. Никогда не храните в базе знаний пароли, API-ключи, секреты или данные клиентов.

## Машиночитаемые ресурсы

- [Канонический HTML](https://ticketcord.com/ru/help/ai/knowledge-base)
- [TicketCord llms.txt](https://ticketcord.com/llms.txt)
- [AI индекс страницы](https://ticketcord.com/api/ai/pages)