Bem vindo ao Eitri Agents

O Eitri Agents é um toolkit poderoso e flexível para a construção de agentes inteligentes, projetado para integrar facilmente inteligência artificial em aplicações desenvolvidas com o framework Eitri. Com ele, você pode criar assistentes virtuais altamente especializados, capazes de interagir com usuários, executar tarefas complexas e integrar-se com diversas ferramentas e APIs.

Dois caminhos, uma biblioteca

O Eitri Agents oferece dois hooks, para duas situações diferentes:

• useAgent — o agente é seu: você escreve o prompt em agents/*.md, define as ferramentas em TypeScript e escolhe o LLM. Ele roda na infraestrutura de agentes do Eitri, com suporte a tools, RAG e áudio. Comece pela Configuração.
• useAgentVtexCX — o atendimento já está montado no VTEX CX Platform e o seu app é mais um canal dele. A conversa acontece por WebSocket, com a resposta chegando em streaming, além de histórico, catálogo de produtos e respostas rápidas vindos do próprio CX. Comece pela Visão Geral.

Os dois convivem no mesmo app, e as seções deste guia estão separadas por eles.

Principais Recursos do useAgent

• Criação Simples de Agentes: Defina agentes como arquivos Markdown, descrevendo sua personalidade, objetivo e as ferramentas que utilizarão.
• Ferramentas Personalizadas (Tools): Desenvolva funções em TypeScript que seus agentes podem invocar para realizar ações concretas, como buscar dados em uma API, processar informações ou interagir com outros sistemas.
• Hook useAgent para seus Eitri-Apps: Integre agentes facilmente em componentes do Eitri com o hook dedicado, permitindo uma comunicação direta e reativa com os agentes.
• Gerenciamento de Contexto: Mantém o histórico da conversa, permitindo interações mais naturais e contextualizadas.
• Suporte a Múltiplos LLMs: Configure qual modelo de linguagem (LLM) e qual versão específica seu agente utilizará.
• Envio de Imagens: Capacidade de enviar imagens para o agente analisar.
• Personalização Avançada: Opções para logs detalhados (verbose), definição de timeout, e gerenciamento de contexto da conversa.

Principais Recursos do useAgentVtexCX

• Conversa com o agente publicado no VTEX CX Platform, sem duplicar prompt nem ferramentas no app.
• Resposta em streaming: o texto cresce na tela conforme chega do WebSocket.
• Histórico paginado vindo do servidor, e várias conversas por usuário.
• Payloads ricos do CX já normalizados: quick_replies, list_message, cta_message e product_list (inclusive o catálogo que o agente devolve em JSON).
• Envio de imagem e arquivo no mesmo formato do useAgent.
• Reconexão automática com backoff e recuperação de sessão duplicada.

O Eitri Agents oferece uma estrutura clara e poderosa para incorporar IA de forma eficaz e escalável em suas aplicações Eitri.