AiChainOfThoughts

AiChainOfThoughts — цепочка рассуждений AI-агента (Chain of Thoughts) для Гига-помощника: сворачиваемый заголовок «Размышляю» / «Размышлял» с длительностью и список строк-инструментов под ним.

Раскрытие — controlled (opened + onToggle) либо uncontrolled (defaultOpened). Контент цепочки передаётся слотом children (строки @cloud-ru/ds-ai-tool), сам компонент его не запоминает.

Когда использовать

  • Показ процесса рассуждения агента в чате: заголовок со статусом и список выполненных шагов-инструментов.
  • Потоковое отображение размышлений (стриминг) — заголовок остаётся, контент дополняется по мере поступления шагов.

Когда не нужен

  • Одиночный шаг reasoning без заголовка-цепочки:
    • используйте @cloud-ru/ds-ai-reasoning.
  • Отдельный вызов инструмента вне цепочки:
    • используйте AiTool / AiToolSimple из @cloud-ru/ds-ai-tool.

Анатомия

InProgress (default true)

  • true — слева иконка GigaChat, подпись «Размышляю» (настоящее время) и длительность.
  • false — без иконки, подпись «Размышлял» (прошедшее время).

Broken (default false)

Поток рассуждения прерван: вместо длительности и chevron’а заголовок показывает сообщение brokenMessage, контент-цепочка не раскрывается.

Opened (default false)

Раскрытие контент-цепочки. Chevron в заголовке появляется только при наличии children и вне состояния broken.

Установка

pnpm add @cloud-ru/ds-ai-chain-of-thoughts
import { AiChainOfThoughts, AiChainOfThoughtsHeadline } from '@cloud-ru/ds-ai-chain-of-thoughts'

Примеры использования

Default

DefaultЦепочка с раскрытым списком инструментов
Thinking
365d09h09m09s
status_for_users
status_for_users9с
tsx
import { AiChainOfThoughts } from '@cloud-ru/ds-ai-chain-of-thoughts';
import { AI_TOOL_ICON_TYPE, AI_TOOL_STATUS_STATE, AiTool, AiToolSimple } from '@cloud-ru/ds-ai-tool';

export function Default() {
  return (
    <AiChainOfThoughts inProgress duration={31568949} defaultOpened>
      <AiToolSimple name='status_for_users' icon={AI_TOOL_ICON_TYPE.Search} connector />
      <AiTool
        name='status_for_users'
        icon={AI_TOOL_ICON_TYPE.Search}
        state={AI_TOOL_STATUS_STATE.Success}
        duration={9}
        call='{ "user_ids": [1, 2, 3] }'
      />
    </AiChainOfThoughts>
  );
}

Broken

BrokenПрерванный поток рассуждения
Thinking

The response stream was interrupted. The agent keeps working — the full answer will appear once it is ready.

tsx
import { AiChainOfThoughts } from '@cloud-ru/ds-ai-chain-of-thoughts';

export function Broken() {
  return <AiChainOfThoughts broken />;
}

Headline

HeadlineЗаголовок в процессе и завершённый
Thinking
365d09h09m09s
Thought365d09h09m09s
tsx
import { AiChainOfThoughtsHeadline } from '@cloud-ru/ds-ai-chain-of-thoughts';

export function HeadlineStates() {
  return (
    <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
      <AiChainOfThoughtsHeadline inProgress duration={31568949} />
      <AiChainOfThoughtsHeadline inProgress={false} duration={31568949} />
    </div>
  );
}

Props

AiChainOfThoughts

Types

PropsAiChainOfThoughtsProps
PropTypeDefaultRequiredDescription
brokenbooleanfalsenoПоток рассуждения прерван. Заголовок показывает сообщение `brokenMessage`, контент-цепочка не раскрывается. По умолчанию `false`.
brokenMessageReactNodenoТекст сообщения о прерванном потоке (показывается при `broken`).
childrenReactNodenoКонтент-цепочка рассуждения — строки `AiTool` / `AiToolSimple`. Рендерится под заголовком в раскрытом состоянии.
classNamestringnoДоп. класс корня.
data-test-idstringai-chain-of-thoughtsno
defaultOpenedbooleanfalsenoНачальное раскрытое состояние (uncontrolled). По умолчанию `false`.
durationnumbernoДлительность рассуждения в секундах. Форматируется в д/ч/м/с. Скрыта в состоянии `broken`.
inProgressbooleantruenoИдёт ли рассуждение прямо сейчас. `true` — иконка GigaChat и подпись «Размышляю»; `false` — без иконки и «Размышлял». По умолчанию `true`.
labelReactNodenoПодпись заголовка. По умолчанию «Размышляю» / «Размышлял» — по `inProgress`.
onToggle((opened: boolean) => void)noПереключение раскрытия. Получает новое значение `opened`.
openedbooleannoРаскрытое состояние (controlled). Для uncontrolled-режима — `defaultOpened`.

Types

AiChainOfThoughtsProps

AiChainOfThoughtsHeadline

Types

PropsAiChainOfThoughtsHeadlineProps
PropTypeDefaultRequiredDescription
brokenbooleanfalsenoПоток рассуждения прерван. Вместо длительности и chevron'а под подписью показывается сообщение `brokenMessage`. По умолчанию `false`.
brokenMessageReactNodenoТекст сообщения о прерванном потоке (показывается при `broken`).
classNamestringnoДоп. класс корня.
collapsiblebooleanfalsenoРендерить ли chevron-кнопку раскрытия. Управляется родителем (`AiChainOfThoughts` ставит `true`, когда есть раскрываемый контент). В состоянии `broken` chevron не рендерится. По умолчанию `false`.
data-test-idstringai-chain-of-thoughts-headlineno
durationnumbernoДлительность рассуждения в секундах. Форматируется в д/ч/м/с (ведущие нулевые единицы опускаются, секунды показываются всегда). Скрыта в состоянии `broken`.
inProgressbooleantruenoИдёт ли рассуждение прямо сейчас. `true` — слева иконка GigaChat и подпись «Размышляю» (настоящее время); `false` — без иконки и «Размышлял» (прошедшее время). По умолчанию `true`.
labelReactNodenoПодпись заголовка. По умолчанию «Размышляю» / «Размышлял» — по `inProgress`.
onToggle((opened: boolean) => void)noКлик по chevron'у. Получает новое значение `opened`.
openedbooleanfalsenoРаскрытое состояние — задаёт направление chevron'а. По умолчанию `false`.

Types

AiChainOfThoughtsHeadlineProps

Storybook

Figma