Обучите Atlas на базе знаний
Настройте источники, поддерживайте точность ответов и безопасно подключите Claude Code или Codex для поиска и управления базой знаний TicketCord.
Удобнее смотреть? В этих видео всё показано по шагам. Озвучка на английском, с английскими субтитрами.
Что Atlas умеет усваивать
Источники добавляются в настройках базы знаний в дашборде. На Pro каждый веб-источник может сканировать до 100 страниц, на Enterprise до 500. Этот лимит страниц применяется к URL-источникам; источники Discord, GitHub и файлов следуют собственным правилам. Есть четыре типа источников:
- Отдельная страница. Укажите Atlas URL, и он обойдёт страницу (и несколько настраиваемых уровней вглубь). Лучше всего для справочных статей, FAQ и продуктовых страниц, которые вы уже ведёте на своём сайте.
- Канал Discord. Импортируйте историю сообщений из канала Discord - полезно, когда команда поддержки уже отвечала на те же вопросы публично и вы хотите, чтобы Atlas учился на этих ответах.
- Репозиторий GitHub. Привяжите репозиторий и необязательный путь; Atlas индексирует все найденные там Markdown-файлы (
.md,.mdx). Хорошо для инженерных команд, которые держат документацию рядом с кодом. - Файл. Загрузите файл
.txt,.mdили.docx, например FAQ или политику, в любом оформлении. Отправляется только его текст, а Atlas превращает его в записи «вопрос-ответ». Если из файла нельзя создать записи, источник сообщит причину.
Atlas также отвечает на основе записей Q&A: записей, которые вы пишете сами через Добавить ответ, записей, созданных из ваших файлов, записей, полученных из тикетов, закрытых вашим персоналом, и исправлений, которые персонал вводит, когда голосует против ответа. Просматривайте, редактируйте или удаляйте их на вкладке Q&A персонала.
Структурирование записей
Небольшие сфокусированные источники работают лучше одной гигантской страницы. Из справочного центра с отдельной статьёй на каждую тему («Политика возвратов», «Отмены», «Доступность по регионам») Atlas извлекает чистые ответы гораздо проще, чем из одного мега-документа «Всё, что нужно знать». Atlas цитирует использованный источник в ответе, так что гранулярные источники делают и цитаты полезнее.
Обучение на ответах команды
При включённом обучении Atlas превращает подходящие ответы команды из закрытых тикетов в вопросы и ответы для повторного использования. Режим «Добавлять автоматически» публикует записи, в которых Atlas уверен, в пределах дневных лимитов. Неуверенные записи и записи с пометкой о возможных персональных данных ждут проверки. «Сначала спрашивать меня» отправляет каждую новую запись на одобрение. В новых базах знаний по умолчанию выбрано «Добавлять автоматически»; сохранённая настройка «Выкл.» не меняется.
Чего добавлять не стоит
- Секреты, пароли, API-ключи, данные клиентов.
- Устаревшие политики. Atlas считает каждую запись актуальной.
- Заметки по длительным инцидентам. Для них лучше подходят шаблоны ответов.
Контроль качества
Время от времени открывайте список базы знаний в дашборде и просматривайте его на предмет устаревших записей. Если ответ изменился (цены, политика, поддерживаемый регион), отредактируйте или удалите запись, чтобы Atlas перестал цитировать устаревшую версию. После крупных изменений документации переобходите записи на основе URL, чтобы индекс отражал то, что клиенты реально найдут на вашем сайте.
Управляйте базой знаний с помощью ИИ-инструментов
MCP представляет собой защищённое соединение, которое позволяет Claude Code или Codex работать с базой знаний TicketCord после входа и подтверждения доступа. Вы можете давать задания обычным языком вместо перехода по каждому экрану дашборда.
Перед подключением
- Вы должны быть владельцем учётной записи TicketCord. Сотрудники с доступом к дашборду не могут создавать MCP-подключение.
- Ваш активный тариф должен включать доступ к базе знаний.
- Установите Claude Code или Codex CLI и убедитесь, что можете войти в TicketCord.
- Одно подключение может получить доступ ко всем серверам, которыми вы владеете сейчас или добавите позже. Каждый запрос всё равно указывает одного бота и сервер, а TicketCord заново проверяет владельца и тариф при каждом запросе.
Подключите Claude Code или Codex
- В дашборде выберите бота и сервер. Откройте База знаний > Конфигурация и найдите Подключить ИИ-инструменты.
- Для Claude Code выполните
claude mcp add --transport http ticketcord https://ticketcord.com/api/mcp --scope user, затемclaude mcp login ticketcord. - Для Codex выполните
codex mcp add ticketcord --url https://ticketcord.com/api/mcp, затемcodex mcp login ticketcord. - TicketCord откроется в браузере. Войдите, прочитайте предупреждение о доступе ко всей учётной записи и запрашиваемых правах на чтение, запись и удаление. Затем выберите Разрешить доступ или Отказать.
- Когда появится сообщение Аутентификация завершена, закройте вкладку и вернитесь к ИИ-инструменту. Попробуйте:
Покажи мои базы знаний TicketCord.
Что можно попросить сделать
- Показать базы знаний и проверить настройки, источники, состояние индексации и записи.
- Искать по смыслу и возвращать короткие подходящие фрагменты с названиями источников и уровнем уверенности.
- Добавлять, редактировать, включать, отключать, переиндексировать или удалять веб-страницы, каналы Discord и уже подключённые источники GitHub.
- Создавать и редактировать записи, проверять ожидающие записи и одобрять, отклонять или удалять их.
- Обновлять доступные в дашборде настройки сведений о продукте, триггеров, отображения, качества, поведения, обратной связи, обучения на тикетах и Auto Support.
Полезные примеры запросов
Покажи мои базы знаний и укажи, в каких нет готовых источников.Найди нашу политику возврата средств и сделай краткое резюме с названиями источников.Найди записи со старыми ценами. Сначала покажи их и ничего не меняй.Добавь https://docs.example.com как источник документации и запусти индексацию.Покажи ожидающие записи и перед изменениями порекомендуй одобрить или отклонить их.Покажи текущий ответ о сбросе пароля, а затем помоги его обновить.
Права, безопасность и доступ
- Доступ на чтение позволяет просматривать и искать знания. Запись позволяет менять настройки, источники и записи. Удаление позволяет навсегда удалять источники и записи.
- Для рискованных изменений попросите ИИ-инструмент сначала показать найденные данные и объяснить запланированное действие.
- Удаление необратимо. TicketCord заново проверяет ваши права при каждом запросе, даже после одобрения подключения.
- Если тариф закончится или потеряет доступ к базе знаний, подключение будет приостановлено. Оно может заработать после перехода на подходящий тариф, если вы его не отозвали и срок доступа для продления не истёк.
- Немедленно отзовите подключение с карточки Подключить ИИ-инструменты в настройках базы знаний.
- Подключение и отключение учётной записи GitHub по-прежнему выполняется только в дашборде. Никогда не храните в базе знаний пароли, API-ключи, секреты или данные клиентов.