Добавить промпт ai.prompt.register

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Добавить промпт ai.prompt.register». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Добавить промпт ai.prompt.register

Тут может не хватать некоторых данных — дополним в ближайшее время

  • нужны правки под стандарт написания
  • не указаны типы параметров
  • не указана обязательность параметров
  • отсутствуют примеры
  • отсутствует ответ в случае успеха
  • отсутствует ответ в случае ошибки

> Scope: ai_admin
>
> Кто может выполнять метод: администратор

Метод ai.prompt.register добавляет промпт.

ПараметрОписание
category
unknown
Категория места встройки. CoPilot может располагаться в совершенно разных местах продукта. Список категорий приведён ниже
code
unknown
Уникальный код для промпта. В коде обязательно использовать префикс rest_. Этот код задаётся один раз при регистрации и затем изменить его нельзя.

Обновить препромпт возможно только через его удаление

icon
unknown
Код иконки. Найти подходящую иконку вы можете в файле copilot_icons.pdf
prompt
unknown
Текст промпта. Именно он полетит на съедение нейронке (при этом пользователь его не увидит). В тексте препромпта можно использовать спец.форматирование: маркеры и условия
translate
unknown
Массив переводов пункта на разные языки. В идеале поддержать минимум языков: английский (en) и язык портала. Поддержка других языков — на усмотрение
parent_code
unknown
Код родительской секции. В коде обязательно использовать префикс rest_
sort
unknown
Сортировка, указывается опционально. Отвечает за сортировку пунктов между собой
section
unknown
Категория в меню промптов для визуального разделения. Может иметь значения:

— create — категория «Создать из текста»
— edit — категория «Изменить текст»

Если ничего не указать, промпт будет размещен выше этих категорий

Category

Категория места встройкиГде появится в CoPilot
livefeedПост ленты новостей
livefeed_commentsКомментарий к одному из постов ленты новостей
tasksОписание задачи
tasks_commentsКомментарий к одной из задач
chatСообщение в чате один на один или в групповых чатах
mailПисьма из личного ящика в почте
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 и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Настройка модуля «Складской учет» в Битрикс24: оприходование, перемещение, списаниеНастройка модуля «Складской учет» в Битрикс24: оприходование, перемещение, списание

Профессиональная настройка и комплексная автоматизация Битрикс24 CRM позволяет выстроить прозрачный отдел продаж, исключить потерю обращений и автоматизировать рутинный документооборот компании. Услуга «Настройка модуля «Складской учет» в Битрикс24: оприходование, перемещение, списание»

Как использовать метод SDK crm.enum.contentType в Битрикс24Как использовать метод SDK crm.enum.contentType в Битрикс24

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Как использовать метод SDK crm.enum.contentType в Битрикс24», проанализируем

Удалить файл из папки чата im.disk.file.deleteУдалить файл из папки чата im.disk.file.delete

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Удалить файл из папки чата im.disk.file.delete». Мы подготовили подробный разбор принципов работы и развернутые примеры