Написать служебную записку с помощью нейросети: API
Написать служебную записку с помощью нейросети можно по готовым фактам: кто обращается, что произошло и какое решение требуется. Через API Relay модель оформит черновик, но не подтвердит обстоятельства и не согласует документ за руководителя. Соберите бриф, уберите лишние персональные сведения, получите текст и сверьте его с первоисточником. Даты и причины, которых нет во входе, добавлять нельзя.
Как написать служебную записку с помощью нейросети
Начните с просьбы автора. «Сообщить о сбое» и «согласовать замену оборудования» требуют разного текста, даже если событие одно. Запишите желаемое действие одним предложением: так его легче проверить в готовом черновике.
Подготовьте поля брифа:
Укажите адресата и автора так, как требует внутренний шаблон компании.
Опишите наблюдаемое событие, его дату и подтверждённые последствия.
Приложите ссылку на внутренний источник для проверки человеком.
Сформулируйте просьбу и перечислите существующие приложения.
Если срок решения неизвестен, не просите модель выбрать его самостоятельно. Верните вопрос автору. Записка с конкретной просьбой без придуманной даты полезнее текста с уверенным, но неподтверждённым обязательством.
Как подготовить текст без лишних сведений
Замените ФИО и реквизиты ролями, если они не нужны для составления фраз. Таблицу соответствия храните внутри компании. Обезличенный текст тоже может раскрывать обстоятельства, поэтому передавайте только сведения, разрешённые вашим порядком обработки документов.
Для черновика обычно не нужен полный договор или весь журнал инцидента. Извлеките факт, который должен попасть в записку, а источник оставьте рядом с заявкой. API-ключ, пароли и токены доступа в текст запроса не включайте.
Разделите факт и предположение. «Приложение не отвечало» описывает наблюдение. «Поставщик допустил ошибку» уже приписывает причину. Если источник подтверждает только первое, бриф и записка должны ограничиваться первым.
Как вызвать Claude через Anthropic Messages
В каталоге Relay есть claude-sonnet-5 с поддержкой Anthropic Messages. Для Python потребуется пакет anthropic, ключ в RELAY_API_KEY и базовый адрес без /v1. Клиент SDK сам добавляет путь /v1/messages.
Ниже учебный бриф. Замените его факты подтверждёнными сведениями своей задачи, не копируйте пример как описание реального события.
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["RELAY_API_KEY"],
base_url="https://relay-llm.ru",
)
brief = """Адресат: руководитель отдела.
Автор: дежурный инженер.
Событие: внутренний сервис временно не отвечал.
Подтверждение: запись дежурной смены.
Последствие: сотрудники не могли открыть форму заявки.
Причина и точная длительность пока не установлены.
Просьба: согласовать разбор причины сбоя.
Приложения: отсутствуют."""
reply = client.messages.create(
model="claude-sonnet-5",
max_tokens=700,
system=(
"Составь нейтральный черновик служебной записки. "
"Используй только факты брифа. Не назначай виновных, "
"не добавляй даты, номера документов и сроки. "
"Сохрани адресата, автора, событие и просьбу."
),
messages=[{"role": "user", "content": brief}],
)
if reply.stop_reason != "end_turn":
raise ValueError("Черновик не завершён")
text = "\n".join(block.text for block in reply.content if block.type == "text")
if not text.strip():
raise ValueError("Нет текста записки")
print(text)В этом протоколе постоянное правило находится в поле system, а ответ состоит из блоков content. Форматы разобраны в документации Messages. Не подставляйте сюда разбор choices[0] из OpenAI SDK.
Что исправить перед согласованием
Сверьте черновик построчно с брифом. Найдите каждое добавленное число, должность, причину и оценку действий людей. Удалите утверждения без источника. Если модель пропустила неизвестную длительность и заменила её словом «долго», уберите и эту оценку.
Проверьте просьбу отдельно. Адресат должен понимать, какое решение от него требуется: согласовать разбор, выделить оборудование или назначить встречу. Общее «принять меры» не сообщает, что делать. Формулировку решения выбирает автор записки.
Подставьте имена и реквизиты из внутренней формы после генерации. Затем сравните их с первоисточником: повторное использование шаблона легко переносит старую должность или номер заявки. Если у компании есть обязательная форма, перенесите согласованный текст в неё, не поручайте модели воспроизводить оформление по памяти.
Как повторно использовать шаблон
Разделите постоянные правила и поля конкретной записки. До вызова проверьте, что заполнены событие и просьба. При отсутствии обязательного поля задайте автору вопрос, вместо того чтобы просить модель закончить текст наугад.
Сохраняйте исходный ответ отдельно от правок согласующего. Это покажет, какие формулировки нужно запретить в следующей версии шаблона. В технические логи достаточно записать ID модели, статус и x-request-id; полный документ там не нужен.
Проверьте фактический расход в журнале кабинета, а ставку модели на странице цен. Для повторной редакции передавайте конкретное замечание, например «убери предположение о причине», вместо запроса написать записку заново.
FAQ
Можно ли написать служебную записку с помощью нейросети без даты события?
Можно подготовить черновик по известным сведениям. Отсутствующую дату уточняет автор; модель не должна придумывать её ради заполнения формы.
Можно ли считать ответ готовым документом?
Сначала автор проверяет факты и реквизиты, затем передаёт текст по принятому в компании маршруту согласования.
Почему нейросеть добавила виновного?
Она могла достроить объяснение события. Удалите вывод без доказательства, уточните запрет в шаблоне и проверьте следующий ответ по исходному брифу.