[03.AI] Pilar 03

Agents UI

Componentes reutilizaveis para interfaces de agentes de IA. Controles de midia, visualizadores de audio, chat em tempo real e gerenciamento de sessao.

LiveKitReal-timeVoice AIMultimodal
[01]

Session Provider

O AgentSessionProvider envolve toda a interface do agente, fornecendo contexto de sessao e renderizacao de audio.

PROVIDERREQUIRED
<AgentSessionProvider session={agentSession}>
  <AgentControlBar />
  <AgentChatTranscript
    agentState={agentState}
    messages={chatMessages}
  />
</AgentSessionProvider>
session

UseSessionReturn — obrigatorio

volume

number — volume do audio renderer

muted

boolean — silenciar renderer

[02]

Track Toggles

Controles individuais para microfone, camera e compartilhamento de tela. Suporte a estados controlado/nao-controlado e icones automaticos por source.

VARIANTDEFAULT
Microphone — ON
Camera — OFF
Screen Share — OFF
VARIANTOUTLINE
Outline Mic
Outline Camera
Outline Screen
SIZES
sm
default
lg
STATESPENDING
Loading...
[03]

Disconnect Button

Botao de desconexao que encerra a sessao do agente. Usa o contexto de sessao para chamar end().

VARIANTS
default
icon
outline
ghost
[04]

Chat Indicator

Indicador animado de "thinking" para o chat do agente. Usa spring animation com repeat infinito.

SIZES
sm (2.5)
md (4)
lg (6)
[05]

Chat Transcript

Exibe historico de conversa entre usuario e agente. Inclui scroll automatico, timestamps e indicador de thinking. Construido sobre primitivos ai-elements.

PREVIEW
Agent Online
Qual e o status do deploy?
O deploy da v2.3.1 foi concluido com sucesso. Todos os health checks passaram e o uptime esta em 99.97%.
Pode rodar os testes de integracao?
Thinking...
agentState

AgentState — controla indicador

messages

ReceivedMessage[] — historico

auto-scroll

Scroll automatico ao bottom

[06]

Audio Visualizers

5 variantes de visualizacao de audio que reagem ao estado do agente e ao volume do audio em tempo real. Cada visualizer aceita state, color, size e audioTrack como props.

BAR5 SIZES
icon
sm
md
RADIAL

24 dots · circular layout

GRID

5x5 grid · pattern animation

WAVE

canvas-based · bell curve attenuation

AURACANVAS + RADIAL GRADIENT

Multi-layer radial gradient · audio-reactive scale & opacity

AGENT STATES
connecting
initializing
listening
thinking
speaking
disconnected
[07]

AI Elements

Primitivos de baixo nivel para construir interfaces de chat. Base para o AgentChatTranscript.

CONVERSATION
Conversation — container flex col
ConversationContent — area scrollavel
ConversationScrollButton — scroll to bottom
MESSAGE
Message — from: "user" | "assistant"
MessageContent — wrapper de conteudo
MessageResponse — texto da resposta
[08]

Toggle

Componente base shadcn/ui Toggle adicionado como dependencia dos agents-ui. Usa Radix Toggle primitive.

VARIANTS
default on
default off
outline on
outline off