Aruna — a assistente da plataforma

A Aruna é a assistente inteligente do Inthub Services. Ela fica disponível em qualquer tela do console, no botão de chat, e responde duas famílias de pergunta: sobre os seus recursos de verdade e sobre como a plataforma funciona, consultando esta documentação.

Essa é a diferença que importa: quando você pergunta "quantas mensagens a pipeline de pedidos processou na última hora", ela vai consultar as métricas reais daquela pipeline e responder com os números. Ela não inventa dado nenhum — toda resposta sai de uma consulta feita na hora.

O que ela consegue fazer

Encontrar e explicar o que existe

Ela enxerga tudo o que a sua empresa criou: pipelines, nodes, tópicos, conectores, clusters Kafka Connect, brokers, conexões, plugins, secrets, tags e clusters de destino.

"Quantas pipelines eu tenho?"

"Lista as pipelines com a tag financeiro."

"Quais tópicos a pipeline erp-para-datalake usa?"

"Quais secrets existem e onde cada um é usado?"

Mostrar como algo está configurado

"Me mostra o YAML gerado da pipeline pedidos-para-busca."

"Quais variáveis de deploy estão configuradas para a pipeline X no cluster de produção?"

"Quais versões da pipeline erp-para-datalake existem e quando cada uma subiu?"

"Quais nodes essa pipeline tem e de qual tópico cada um consome?"

Responder "como isso funciona"

Ela lê esta documentação. Perguntas sobre conceitos, campos e passo a passo são respondidas a partir das mesmas páginas que você está lendo agora — e ela cita qual página usou.

"O que significa o campo Sufixo do Group ID?"

"Qual a diferença entre um Output e um conector do Kafka Connect?"

"Como eu refaço a carga inicial de uma tabela do zero?"

"O que acontece com uma exclusão quando o destino é o Elasticsearch?"

É útil justamente quando você não sabe o nome da página onde a resposta está.

Investigar um problema

É aqui que ela mais economiza tempo. Ela alcança métricas, logs, eventos dos pods, lag por tópico e o estado do ArgoCD — as mesmas fontes da tela de observabilidade, só que cruzadas para você.

"A pipeline erp-para-datalake está com problema. O que está acontecendo?"

"Me mostra os logs de erro do node 3 da pipeline X nos últimos 30 minutos."

"Por que esse deploy está com status Degraded?"

"O lag do tópico pedidos-n1-sqlserver está subindo. Onde está o gargalo?"

"O pod dessa pipeline está reiniciando. Quais foram os eventos?"

Ela também consegue testar conectividade: se a suspeita é que o banco de destino não está acessível a partir do cluster, ela verifica host e porta antes de sugerir qualquer outra causa.

"O connector não conecta no SQL Server. O host sqlserver.empresa.com na porta 1433 está acessível a partir do cluster de produção?"

Como perguntar bem

A Aruna funciona melhor com contexto. Três hábitos que mudam muito a qualidade da resposta:

1. Diga o nome do recurso. "A pipeline está lenta" obriga ela a adivinhar qual. "A pipeline pedidos-para-busca está lenta" vai direto ao ponto.

2. Diga o cluster quando houver mais de um. A mesma pipeline pode estar no ar em produção e em homologação, com comportamentos diferentes.

3. Diga a janela de tempo. "Nos últimos 15 minutos", "desde ontem à noite", "na última hora" — isso muda quais métricas e logs ela busca.

Comparando:

Em vez de	Pergunte
"Está dando erro"	"A pipeline x no cluster de produção está com erro desde as 14h. O que os logs mostram?"
"Como está o consumo?"	"Qual o uso de CPU e memória dos nodes da pipeline x na última hora?"
"Meu dado não chegou"	"A pipeline x recebeu mensagens na última hora? E o Output entregou?"

E você pode continuar a conversa: "e o node 2?", "mostra os logs desse", "compara com ontem". Ela mantém o contexto do que já foi perguntado.

O que ela não faz

• Não altera nada. Ela consulta e explica; criar, publicar e apagar continua sendo você.
• Não passa comandos de cluster. Você não tem acesso direto ao Kubernetes, e ela sabe disso.
• Não responde fora do escopo da plataforma. Perguntas que não caem em nenhuma das consultas que ela sabe fazer recebem um "ainda não posso ajudar com isso" — o que é melhor do que uma resposta inventada.

Configuração e créditos

A Aruna funciona com uma chave de IA da sua própria empresa, cadastrada em Workspace → Configurações. Ali você escolhe o provedor — Claude, Gemini ou GPT — e informa a chave da conta.

Erros quando o crédito acaba

O consumo da Aruna é cobrado na conta do provedor que você configurou. Quando essa conta fica sem crédito, estoura a cota ou tem a chave revogada, a Aruna passa a responder com uma mensagem de erro no chat, marcada com ⚠️.

Isso não é falha da plataforma, e o resto do console continua funcionando normalmente — suas pipelines seguem rodando. O que parou foi só a assistente.

O que fazer: confira o saldo e os limites da conta no painel do provedor e, se a chave foi trocada, atualize-a em Workspace → Configurações.

Outras mensagens de erro que aparecem no mesmo lugar:

O que aparece	O que significa
"API key não configurada"	Nenhuma chave foi cadastrada ainda para o provedor selecionado
Erro de crédito ou cota do provedor	A conta ficou sem saldo ou atingiu o limite de uso
Erro ao contatar o serviço	Instabilidade momentânea — tente de novo

Perguntas longas, com muitos recursos envolvidos, consomem mais. Se o orçamento é apertado, prefira perguntas específicas ("os logs do node 3") a perguntas amplas ("tudo o que está errado na plataforma").

Aruna dentro do editor de código

Além do chat geral, a Aruna aparece dentro do editor de um Transform, para ajudar a escrever e revisar o código Go da função.

Ali ela serve para o de sempre: explicar um erro de compilação, sugerir como transformar um formato em outro, revisar o que você escreveu. O código sugerido é sempre editável, e nada é aplicado sem você salvar.

Privacidade

A Aruna só enxerga os recursos da sua empresa — o mesmo isolamento que vale para o resto da plataforma. Ela não tem como consultar dados de outra empresa, mesmo que alguém peça.

Os valores dos Secrets continuam no cofre: ela consegue listar quais secrets existem e onde são usados, não o conteúdo deles.

Controles do chat

Botão	O que faz
Limpar conversa	Apaga o histórico da tela e começa do zero
Minimizar	Recolhe o chat sem perder a conversa
Encerrar sessão	Fecha a conversa por completo

Limpar a conversa também é a saída quando as respostas começarem a puxar contexto de um assunto antigo que não interessa mais.