Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Добавить промпт ai.prompt.register». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.
Добавить промпт ai.prompt.register
Тут может не хватать некоторых данных — дополним в ближайшее время
- нужны правки под стандарт написания
- не указаны типы параметров
- не указана обязательность параметров
- отсутствуют примеры
- отсутствует ответ в случае успеха
- отсутствует ответ в случае ошибки
> Scope: ai_admin
>
> Кто может выполнять метод: администратор
Метод ai.prompt.register добавляет промпт.
| Параметр | Описание |
|---|---|
categoryunknown | Категория места встройки. CoPilot может располагаться в совершенно разных местах продукта. Список категорий приведён ниже |
codeunknown | Уникальный код для промпта. В коде обязательно использовать префикс rest_. Этот код задаётся один раз при регистрации и затем изменить его нельзя.Обновить препромпт возможно только через его удаление |
iconunknown | Код иконки. Найти подходящую иконку вы можете в файле copilot_icons.pdf |
promptunknown | Текст промпта. Именно он полетит на съедение нейронке (при этом пользователь его не увидит). В тексте препромпта можно использовать спец.форматирование: маркеры и условия |
translateunknown | Массив переводов пункта на разные языки. В идеале поддержать минимум языков: английский (en) и язык портала. Поддержка других языков — на усмотрение |
parent_codeunknown | Код родительской секции. В коде обязательно использовать префикс rest_ |
sortunknown | Сортировка, указывается опционально. Отвечает за сортировку пунктов между собой |
sectionunknown | Категория в меню промптов для визуального разделения. Может иметь значения: — create — категория «Создать из текста» Если ничего не указать, промпт будет размещен выше этих категорий |
Category
| Категория места встройки | Где появится в CoPilot |
|---|---|
| livefeed | Пост ленты новостей |
| livefeed_comments | Комментарий к одному из постов ленты новостей |
| tasks | Описание задачи |
| tasks_comments | Комментарий к одной из задач |
| chat | Сообщение в чате один на один или в групповых чатах |
| Письма из личного ящика в почте | |
| mail_crm | Письма с клиентами CRM в карточке сделок, контактов, компаний |
| landing | Тексты в конструкторе сайтов Б24 |
Практические примеры использования в коде
- cURL (Webhook)
// пример для cURL (Webhook)
- cURL (OAuth)
// пример для cURL (OAuth)
- JS
try
{
const response = await $b24.callMethod(
'ai.prompt.register',
{
category: [
"livefeed",
"livefeed_comments"
],
code: 'rest_joke',
icon: 'smile',
prompt: 'Расскажи анекдот',
translate: {
"en":"A joke",
"ru":"Анекдот"
}
}
);
const result = response.getData().result;
console.info(result);
}
catch( error )
{
console.error(error);
}- PHP
try {
$response = $b24Service
->core
->call(
'ai.prompt.register',
[
'category' => [
"livefeed",
"livefeed_comments"
],
'code' => 'rest_joke',
'icon' => 'smile',
'prompt' => 'Расскажи анекдот',
'translate' => [
"en" => "A joke",
"ru" => "Анекдот"
]
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error registering AI prompt: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
'ai.prompt.register',
{
category: [
"livefeed",
"livefeed_comments"
],
code: 'rest_joke',
icon: 'smile',
prompt: 'Расскажи анекдот',
translate: {
"en":"A joke",
"ru":"Анекдот"
}
},
function(result)
{
if(result.error())
{
console.error(result.error());
}
else
{
console.info(result.data());
}
}
);- PHP CRest
// пример для php
Ответ в случае успеха
Ответ в случае ошибки
Частые кейсы и сценарии
- [](../../../tutorials/ai/add-joke-prompt)
💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к ai.prompt.register, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «Добавить промпт ai.prompt.register».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru