ThenaJSAgentes de IA em TypeScript

A lógica no .ts, o prompt no .md. O framework une os dois e cuida do resto.

Começar

Seu primeiro agente

GitHub

🧩

Um agente é uma classe

Decore com @Agent, aponte o prompt em markdown, e pronto. Sem boilerplate de mensagens, sem montar payload de API.

Ver o exemplo

🛠️

Tools sem if/else

Você descreve a ação com um schema Zod. Detectar que o modelo quer chamá-la, validar os argumentos e executar é trabalho do framework — nunca seu.

Como funciona

🔍

Nada de caixa-preta

Um report em HTML mostra a árvore da execução — o que foi enviado ao modelo, o que ele decidiu, quanto custou. E o Flow desenha tudo isso ao vivo, enquanto roda.

Ver o report

Em trinta segundos

bash

npm install -g @thenajs/cli
thena create meu-agente
cd meu-agente && npm install && npm start

E um agente é isto:

// src/agents/explorer/explorer.agent.ts
import { Agent } from "@thenajs/core";
import { ShellTool } from "@thenajs/tools";
import { LocalOllamaProvider } from "../../providers/ollama.provider.js";

@Agent({
  provider: LocalOllamaProvider,
  tools: [ShellTool],
  prompt: "./explorer.agent.md", // o comportamento vive no markdown
})
export class ExplorerAgent {}

<!-- src/agents/explorer/explorer.agent.md -->
Você explora projetos de software.

Use o shell para investigar antes de responder. Prefira comandos de leitura.

Nenhuma linha para tratar mensagens, chamar a API, detectar tool call ou validar argumentos. Isso é o que o framework faz — e a página O que é automático lista exatamente o quê, para você não ficar adivinhando.

Por onde seguir

Se você quer…	Vá para
entender se serve para o seu caso	O que é ThenaJS
ver algo rodando em 10 minutos	Seu primeiro agente
saber o que acontece por baixo	O que é automático
resolver uma tarefa específica	Guias
consultar uma assinatura	Referência
destravar de um erro	Problemas comuns