Assistant

This page has not been translated into English yet. The Russian original is below.

ИИ-помощник сайта: посетитель задаёт вопрос и получает ответ по базе знаний самого сайта — со ссылкой на страницу под каждым утверждением.

Тип: wrapper Только веб: отвечает сервер, который раздаёт сайт. В приложении, в превью редактора и на экспортированном сайте отвечать некому: элемент рисует ребёнка, state — unavailable , ask ничего не делает.

State @q:""
  Assistant question:$q consent:true ask:@ask state:@st message:@msg blocks:@blocks action:@next pending:@busy
    Column crossAxisAlignment:stretch size:min spacing:12
      TextField value:$q onSubmitted:(){ask()}
      ElevatedButton onPressed:(){ask()}
        Text "Спросить"
      Text "Вопрос обрабатывает ИИ-сервис, и он может храниться."
      Text "Ищу…" if:$busy
      Text $msg
      ListView.builder itemCount:{length(blocks)} shrinkWrap:true
        @Macros id:itemBuilder index:0
          Column crossAxisAlignment:stretch size:min
            Text {blocks[index]["text"]}
            Container
              #web href:{blocks[index]["source"]["url"] ?? ""}
              Text {blocks[index]["source"]["title"] ?? ""}
      Container
        #web href:{next["url"] ?? ""}
        Text {next["title"] ?? ""}

По чему помощник отвечает, для чего он и какие у него лимиты, в разметке не пишется — это лежит в каталоге проекта: ИИ-помощник сайта .

Параметры

Карточки в ответе

Ответ бывает не только сказан, но и показан: рядом с утверждениями помощник может вывести записи из каталога владельца — тариф, услугу, раздел. Каждая такая запись приходит блоком со своим kind (по умолчанию card ) и полями, которые владелец записал в каталоге: title , text , image , url , цена — что угодно. Плюс scenario и id .

Макет карточки пишет автор страницы. Строка списка переключает его по kind :

ListView.builder itemCount:{length(blocks)} shrinkWrap:true
  @Macros id:itemBuilder index:0
    Column crossAxisAlignment:stretch size:min
      // Утверждение с источником.
      Column crossAxisAlignment:stretch size:min if:{blocks[index]["kind"] == "text"}
        Text {blocks[index]["text"] ?? ""}
        Container
          #web href:{blocks[index]["source"]["url"] ?? ""}
          Text {blocks[index]["source"]["title"] ?? ""}
      // Карточка: всё, что на ней написано, — из записи каталога.
      Container if:{blocks[index]["kind"] == "card"}
        #web href:{blocks[index]["url"] ?? ""}
        Column crossAxisAlignment:stretch size:min
          Image src:{blocks[index]["image"] ?? ""} if:{blocks[index]["image"] != null}
          Text {blocks[index]["title"] ?? ""}
          Text {blocks[index]["text"] ?? ""}

• Поле, которого в записи нет, приходит пустым: читайте его через ?? "" , а картинку показывайте, только когда она есть — иначе на странице останется пустой img .
• Ни названия, ни цены, ни картинки, ни адреса модель не пишет: она называет записи по идентификатору, поля подставляет сервер. Выдуманной цены в карточке быть не может.
• Как завести каталог — в описании помощника .

Состояния

Как это работает

• Обёртка. Выходы элемента видит только его поддерево: поле, кнопка и ответ лежат внутри. Кнопка рядом вопроса не задаст.
• Без согласия вопрос не уходит. Привяжите consent: к галочке ( consent:$agreed ) или напишите consent:true , если согласие сказано словами рядом с полем и нажатие кнопки им и является.
• Ни адреса, ни ключа. Вопрос идёт на адрес этого же сайта.
• Проверку «я не бот» писать не нужно. Незнакомец после первого вопроса проходит невидимую проверку, и вопрос повторяется за него сам; для страницы это по-прежнему один asking . Это собственная проверка платформы — элемент Captcha и settings.captcha в ней не участвуют.
• Лимиты держит сервер. Сколько вопросов можно задать и пауза за вопросы не по теме страницей не считаются: ей приходит paused .
• Ссылку под утверждением строит сервер. source.url ведёт на страницу и раздел, откуда взято утверждение; пусто, если у документа нет страницы.

Чего не делать

• Не собирайте то же самое из HttpData : запрос уйдёт, а согласие, проверка и счётчики посетителя — нет.
• Не выводите text как разметку или HTML: это обычный текст.
• Не ждите ответа в превью редактора: помощника смотрят на опубликованном сайте.