Написание длинного документа
Настройте типы документов, запустите редактор текста, управляйте кратким описанием раздела, переписывайте фрагменты, используйте версии, добавляйте собственный материал, экспортируйте в PDF и переводите копию.
Для чего это нужно
Большая часть того, что делает агент, укладывается в один ответ. Это предназначено для того, что вы передаёте кому-то другому: регуляторное досье, отчёт о выходе на рынок, меморандум о проверке (due diligence), ответ на тендер. Агент сначала планирует структуру, запрашивает всё необходимое перед началом, исследует каждый раздел и пишет его по очереди в фоновом режиме — пока вы читаете и редактируете результат в канвасе рядом с чатом.
Если вы новичок в этой идее, начните со страницы концепции длинных текстов. Эта страница — руководство к действию.
1. Определите тип документа
Тип документа — это переиспользуемое определение одного вида документа, который вы создаёте. Вы создаёте их в консоли в разделе Document types (Типы документов). Каждый тип содержит:
| Поле | Что оно делает |
|---|---|
| Outline (Структура) | Скелет: ключи разделов, заголовки, порядок, что должен охватывать каждый раздел, целевая длина и какие обязательные факты от него зависят. Оставьте пустым, чтобы агент предложил структуру для каждого документа. |
| Required information (Обязательная информация) | Небольшой набор фактов, которыми владеет только клиент: юридический производитель, целевой рынок, срок. Агент запрашивает эти данные перед написанием. |
| Boundary (Границы) | Что этот документ никогда не должен делать: никогда не цитировать ставку, никогда не предсказывать результат, никогда не утверждать классификацию как окончательную. Система прикрепляет это к инструкциям каждого раздела. |
| Knowledge bases (Базы знаний) | Какие из ваших баз знаний может использовать этот тип. Это разрешение, а не подсказка — оно пересекается с тем, к чему сам агент имеет доступ. |
| When to use (Когда использовать) | Описание на обычном языке того, когда применим этот тип. Используется для распознавания типа по тому, что вводит клиент. |
Тип является черновиком, пока вы не опубликуете его. Публикация фиксирует ревизию, и документ, который уже запущен, остаётся привязанным к той ревизии, с которой он начался — поэтому редактирование типа сегодня днём никогда не приведёт к перенумерации документа, начатого сегодня утром.
Ключи разделов — это идентификаторы, а не текст. Переименование ключа нарушит якоря в документах, уже написанных на основе этого типа. Меняйте заголовок свободно; не меняйте ключ.
2. Запустите документ
Три способа входа, все они используют одну производственную линию:
- Меню + → Write a document (Написать документ), затем скажите, о чём он должен быть.
- Просто скажите — «напиши мне полный отчёт о регистрации этого устройства в Бразилии». Ввод текста эквивалентен выбору его из меню.
- Из шага сценария, который создаёт результат.
Если в запросе отсутствует предмет («напиши документ»), агент спросит, о чём именно — он не догадывается, потому что документ, написанный на основе догадки о предмете, является самым дорогим видом догадки.
3. Он спрашивает перед началом
Агент проверяет обязательную информацию типа против того, что он уже знает — включая всё, что клиент сказал ранее в разговоре — и запрашивает недостающее, по одному пункту, с пояснением, зачем это нужно.
Ничего не генерируется и ничего не оплачивается, пока эти ответы не будут получены. Для анонимных посетителей по ссылке на общий доступ есть дополнительный шаг: адрес электронной почты перед началом работы. Это и фильтр затрат, и способ, которым они получат документ позже.
4. Подтвердите, затем он пишет
Перед началом написания вы видите точное количество разделов и оценку токенов. Эта пауза преднамеренна — это последний момент перед дорогой частью.
Затем задача выполняется. Несколько важных моментов:
- Вы можете закрыть вкладку. Работа — это фоновая задача, а не запрос. Вернитесь по той же ссылке.
- Перезапуск переносим. Если сервер перезагрузится посередине документа, текущий раздел будет переписан с начала, а завершённые разделы останутся нетронутыми.
- Вы можете остановить его. Уже написанные разделы сохраняются — за них уже заплатили.
- Прогресс идёт по разделам: какой сейчас раздел и какие домены он прочитал для этого раздела.
5. Откуда берутся факты
Каждый раздел исследует самостоятельно, в следующем порядке: сначала ваши базы знаний, затем — только если для этого агента включены публичные источники — поиск в интернете, где он открывает и читает страницу, а не отвечает на основе сводки поиска. Каждый факт сохраняется рядом с источником, из которого он получен.
Затем раздел пишется только на основе этих фактов. Детали, которые не появляются ни в одном источнике, помечаются кодом, сканирующим готовый текст, а не путём опроса модели о том, была ли она осторожной.
Тип документа не может самостоятельно включать публичные источники. Если вы отключили их для агента, это решение действует — тип может быть уже, чем агент, но никогда шире.
6. Управляйте разделом
У каждого раздела есть три элемента управления при наведении на строку статуса самого раздела:
- Brief (Краткое описание) — инструкции, которые даются модели для этого раздела. Редактирование и выбор save and rewrite (сохранить и переписать) перезапускает только этот раздел. Это самый быстрый способ исправить раздел, который получился общим.
- Edit (Редактировать) — сам текст в полноэкранном редакторе markdown. Ручное редактирование помечает раздел как отредактированный, и писатель никогда не перезаписывает отредактированный раздел.
- History (История) — каждая версия этого раздела (см. ниже).
Чтобы изменить один фрагмент, выделите его в тексте и скажите, что вы хотите:
Заменяется только этот фрагмент; остальная часть раздела остаётся идентичной посимвольно. Вы можете просмотреть замену перед применением. Тот же путь обрабатывает полную перезапись раздела — это выделение всего раздела.
7. История и возврат
Откройте History (Историю) для любого раздела. Вы получаете каждую версию: ту, в которой он был написан изначально, ваши ручные правки, каждый запрошенный перезапуск и каждое восстановление — с датой, длиной, каким фрагментом он затронул и, для запрошенного перезапуска, что вы попросили своими словами.
Выберите версию, чтобы увидеть её построчное сравнение с текущим текстом или прочитать полностью. Restore this version (Восстановить эту версию) возвращает её — добавляя новую версию. Ничего в истории никогда не удаляется.
8. Добавьте свой материал в середине документа
Перетащите файл в чат, пока документ открыт, и он станет сопутствующим материалом для этого документа: агент сообщит вам, какие разделы он затрагивает, и предложит переписать их. Материал управляется для каждого документа — вы можете видеть, что прикреплено, по источнику, и удалять любой из них.
9. Экспорт и перевод
- PDF с кликабельным оглавлением и номерами страниц. Диаграммы и изображения встроены.
- Переведённые копии — копию документа на другом языке в режиме только для чтения. Оригинал не трогается, якоря разделов общие, и копия помечает себя устаревшей, когда исходный раздел изменяется после перевода. Редактирования принадлежат источнику; переведённая копия предназначена для передачи.
- Обмен — когда вы делитесь разговором, в котором создан документ, есть флажок, указывающий, идут ли вместе с ним документы. По умолчанию он выключен, и читатель получает вид только для чтения. См. Обмен разговором.
Ограничения, о которых стоит знать, прежде чем обещать это клиенту
- Документ ограничен 40 разделами. За этим пределом разделите его.
- Ссылки на экспорт истекают; документ — нет. Повторно экспортируйте, когда вам нужна свежая ссылка.
- Экспорт в PDF требует установки компонента экспорта на развертывание. Если кнопки нет, вот почему — она не выдаёт ошибку, она просто не появляется.
- Написание длинных текстов привязано к агенту. Включите его для агентов, которые создают результаты, а не для бота FAQ.