Pular para o conteúdo

IA em produção com versão, teste e custo

AI Engineering · Agentes, LLMOps e gateway de modelos

Agentes, fluxos, bases de conhecimento, avaliações, prompts, skills e o acesso aos modelos ficam num lugar só, cada um com versão, permissão e custo medido por chamada. A governança diz até onde cada agente vai, e o trace mostra o que cada execução fez.

O problema

O que este produto resolve

Quando cada time integra IA do seu jeito, ninguém sabe que prompt está no ar, que documento o agente leu nem quanto aquilo custou.

O primeiro problema sério, uma resposta errada ou uma ação que ninguém autorizou, mostra que não havia versão, teste nem registro.

E quando os agentes se multiplicam, falta um lugar para dizer o que cada um pode fazer sozinho e para desligar o que saiu do esperado.

atualizado em

Quem usa e para quê

Perfis típicos, sem nomes de clientes. Cada uso leva o status da funcionalidade que o atende.

  • Time de atendimento de uma seguradoraResponder com base nos documentos internos, citando a fonte de cada resposta.Knowledge bases
  • Time de produto que constrói com IAPublicar só a versão de prompt ou agente que passou na avaliação.Evals
  • Time de plataforma e segurançaDefinir o nível de autonomia e a rede de cada agente, e desligar um agente na hora.Agent governance

Funcionalidades

O que o produto faz

Contratação pela conta, em autoatendimento.

  • Agent Management

    Agentes com versão, ferramentas permitidas, aprovação humana e escrita simulada.

  • Specialist & worker agents

    Agentes especialistas que só leem e workers que só propõem, com política, tetos e revisão humana.

  • Agent governance

    Autonomia por agente (observar, propor, executar com aprovação, executar dentro da política com orçamento), nível de confiança com revisão em quatro olhos, política de rede por agente e kill switch por agente e por organização, com cada decisão na trilha.

  • Agent operations

    Anotação humana das execuções com taxonomia própria, execução real virando caso de avaliação e dataset JSONL com máscara de dados pessoais, sessões com custo por ticket, ambientes com promoção e autonomia por ambiente e por time, AI-BOM em CycloneDX, ingestão OpenTelemetry de agentes externos, avaliações pela API v1 e pelo MCP, busca de código com acesso por repositório e fluxo que chama fluxo.

  • Workflows

    Fluxos com etapas, condições, aprovação e agenda.

  • Evals

    Casos de teste, juiz por modelo, portão de publicação e comparação de versões.

  • Prompt & config registry

    Prompts versionados, publicação e comparação.

  • Knowledge bases

    Busca com fonte e permissão por documento.

  • Models & Gateway

    API de modelos com provedores, roteamento e modelos liberados por papel.

  • Skills registry

    Catálogo de skills versionadas para agentes de código: manifesto com permissões declaradas, SKILL.md com sha256, publicação só depois da revisão de outra pessoa, download pela API v1 e pelo MCP. A plataforma não executa skills.

  • Execution traces

    Passos de cada execução com custo e latência, sessões por chave livre com custo somado, recebimento de spans OpenTelemetry (OTLP/HTTP JSON) de agentes externos com redação na entrada, AI-BOM em CycloneDX e o Assistente lendo a execução aberta.

Agent Management e Workflows: em detalhe

  • Versões imutáveis de cada agente
  • Aprovação humana antes de toda ferramenta de agente com efeito
  • Trace e custo de cada execução
  • Integração com fluxos do n8n, com callback assinado
  • Cliente MCP com ferramentas revisadas antes do uso
  • Fluxos: processos em blocos, com aprovação humana, agendamento e execução por API
  • Ferramentas de dados: câmbio PTAX do Banco Central e consulta somente leitura a um Postgres da empresa

Knowledge bases: em detalhe

  • Documentos em texto, Markdown e PDF, e planilhas em CSV
  • Busca híbrida, por palavra e por significado
  • Permissão por documento
  • Versões de cada documento
  • Respostas no Chat com citação da fonte

Evals: em detalhe

  • Suítes de avaliação por agente
  • Trava de publicação: a versão só é publicada se passar na suíte
  • Nota dada por modelo, com critério escrito em linguagem natural
  • Comparação entre versões

Models & Gateway: em detalhe

  • Saldo pré-pago em reais, com recarga por Pix
  • Preço que acompanha o dólar oficial (PTAX do Banco Central), com cada reajuste na auditoria
  • Valores em reais no chat, nos agentes, no consumo, nos orçamentos e na auditoria

O que ele não faz

  • Ferramenta com efeito de um agente não roda sem a aprovação de uma pessoa.
  • Sem acesso a shell de produção.
  • Conteúdo de documento é tratado como dado, nunca como instrução.
  • PDF sem OCR: documento escaneado como imagem não é lido.
  • Resultado de avaliação vale para o conjunto testado, não como garantia geral.
  • A plataforma não emite nota fiscal automaticamente.
  • Os modelos rodam nos servidores dos provedores; o processamento pode acontecer fora do Brasil.

Ciclo

Do prompt à produção

O ciclo de um agente na plataforma. Cada etapa leva o status da funcionalidade que a executa.

  1. Prompt versionado

    O prompt ganha versão a cada mudança, com publicação e comparação entre versões.

  2. Conhecimento

    Os documentos que o agente pode consultar, com permissão por documento e fonte citada na resposta.

  3. Versão do agente

    Instruções, modelo, ferramentas liberadas uma a uma e tetos de passos e de custo.

  4. Avaliação

    Casos de teste com nota dada por modelo; a versão que piorou não publica.

  5. Gateway de modelos

    A chamada sai só para modelo liberado no workspace, com custo medido.

  6. Execução com aprovação

    Ferramenta com efeito espera uma pessoa decidir; os passos ficam com custo e latência.

  7. Rastreamento

    Sessões com custo somado e spans de agentes externos recebidos em OpenTelemetry, redigidos na entrada.

O que uma versão de agente define Exemplo com valores fictícios. Teto máximo: 25 passos e US$ 5 por execução; o custo vai em milionésimos de dólar.
{
  "instructions": "Responda dúvidas de reembolso citando a política interna. Para abrir um chamado, peça aprovação.",
  "model": "modelo-liberado-no-workspace",
  "tools": [
    "knowledge_search",
    "simulated_ticket_create"
  ],
  "maxSteps": 8,
  "maxCostMicros": 500000
}

Como funciona

Do começo ao registro

  1. Modelos

    O workspace libera os modelos e as rotas com reserva; toda chamada passa pelo Gateway, com orçamento e política.

  2. Conhecimento

    Documentos na base do workspace, com versão e permissão por documento.

  3. Prompt, agente ou fluxo

    Versão nova a cada mudança, com as ferramentas liberadas para ela e teto de passos e de custo.

  4. Avaliação

    Casos de teste com nota dada por modelo; a versão pior não publica.

  5. Execução

    Ferramenta com efeito de um agente espera aprovação. Num fluxo, a aprovação é a etapa que você coloca antes do conector.

  6. Registro

    Cada passo fica com custo e latência, a sessão junta execuções e spans de agentes externos, e a decisão de quem aprovou entra na auditoria.

Funcionalidades

Funcionalidade por funcionalidade

O que cada uma faz, como funciona, um exemplo tirado da documentação e o que ela não faz. O selo de cada bloco vem do catálogo.

Agent Management

Agentes com versão que param antes de mexer em outro sistema

Um agente é um conjunto de instruções, um modelo e uma lista fechada de ferramentas, gravado como versão. Cada mudança cria uma versão nova; a publicada é a que roda pela tela, pela API e dentro dos fluxos.

Ferramenta que só lê roda direto. Ferramenta com efeito (disparar uma automação, escrever num sistema por MCP) para a execução e mostra o texto exato do que vai fazer. Uma pessoa com permissão aprova ou recusa na área do cliente.

Como funciona

  • Versão com instruções, modelo, ferramentas liberadas uma a uma, teto de passos e teto de custo por execução.
  • Ferramentas: busca nas bases de conhecimento, automações do n8n da empresa, ferramentas de servidores MCP revisadas, consulta só de leitura a um banco Postgres e delegação de subtarefa a outro agente, com até dois níveis e o orçamento que sobra.
  • Aprovação humana com prazo de 24 horas; ferramenta bloqueada pela política do workspace é recusada mesmo depois de aprovada.
  • A ferramenta só roda se está na versão do agente e se quem disparou tem a permissão dela; quem aprova precisa da permissão de aprovador.
  • Escrita simulada: uma ferramenta de teste que percorre o ciclo de aprovação sem tocar em sistema nenhum.
  • Execução por API com chave de escopo "Executar agentes", chave de idempotência obrigatória e aviso de conclusão assinado.
Pela API Inicia a versão publicada do agente (a resposta 202 traz o identificador) e consulta a execução.
curl -sS -X POST "https://aiuby.com/api/platform/agents/$AGENTE_ID/runs" \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"input":"Pedido 4471: conferir e encaminhar","idempotencyKey":"pedido-4471"}'

curl -sS "https://aiuby.com/api/platform/agents/runs/$EXECUCAO_ID" \
  -H "Authorization: Bearer $AIUBY_TOKEN"

O que não faz

  • Nenhuma chave de API aprova: a decisão é sempre de uma pessoa, pela tela.
  • Agentes não têm acesso a shell de produção.
  • Uma chave só consulta as execuções que ela mesma iniciou, com até 20 execuções abertas ao mesmo tempo.
  • Cada execução dispara no máximo 3 automações e faz no máximo 3 escritas por MCP.

Specialist & worker agents

Agentes prontos que consultam e propõem, sem aplicar nada

Um catálogo de agentes mantidos pela AIUBY, em dois papéis. Os especialistas só leem: respondem perguntas sobre custo, segurança de dependências, incidentes, testes e entregas, citando a evidência de cada afirmação. Os workers só propõem: montam um patch, comentários de revisão ou uma nova versão de dependência, e param ali.

Nenhum agente do catálogo executa mudança. A proposta de um worker vira decisão de outra pessoa, com permissão de aprovar, e nunca de quem disparou a execução.

Como funciona

  • Oito especialistas de leitura, cada um com lista fechada de ferramentas e de fontes que pode consultar.
  • Seis workers de proposta; a saída é um artefato para revisão, não uma alteração aplicada.
  • Teto de passos, de custo e de tempo por execução, definido na política de cada agente.
  • Resposta de especialista traz a evidência citada; sem evidência, o agente diz que não sabe.
  • A decisão sobre a proposta cabe a outro gestor: quem executou o worker não aprova o próprio resultado.
  • O custo de IA de cada execução passa pelo Gateway, com as mesmas regras de modelo e orçamento do workspace.

Exemplo de uso

Uma pessoa do time de plataforma pergunta ao especialista de dependências quais serviços usam uma biblioteca com falha conhecida. O agente lê os achados e o grafo de entrega, responde com a lista e a origem de cada item. Em seguida ela dispara o worker de atualização de dependência para um dos serviços: ele devolve a proposta de nova versão, e outra pessoa do time decide se ela segue para o repositório.

O que não faz

  • Nenhum agente do catálogo aplica mudança: especialistas só leem e workers só propõem.
  • Três workers (limpeza de feature flag, cobertura de código e correção de infraestrutura como código) ficam indisponíveis por falta do insumo de que dependem.
  • O nível de cada agente do catálogo é fixo na definição: a organização não transforma um especialista em executor.

Agent governance

Você decide até onde cada agente vai, e desliga quando precisar

Cada agente recebe um nível de autonomia: observar (ferramenta com efeito é negada), propor (a ação vira proposta registrada na trilha), executar com aprovação (o padrão: espera uma pessoa) ou executar dentro da política. Este último dispensa a aprovação só para ferramenta que o admin marcou como de baixo risco e enquanto houver orçamento de ações por execução e por dia; fora disso, volta a pedir aprovação.

Junto vêm o nível de confiança do agente, a política de rede por agente e o kill switch por agente e por organização. Cada decisão sobre uma chamada de ferramenta fica na trilha da execução, com nível, confiança, ferramenta, decisão, motivo e destinos, e cada mudança de regra fica na auditoria.

Como funciona

  • Quatro níveis de autonomia por agente; "executar dentro da política" vem desligado, e o admin precisa ligar nas regras da organização antes de escolher esse nível.
  • Níveis de confiança: gerenciado (catálogo da AIUBY), verificado (revisado pela organização) e não revisado (importado). Agente importado só vira verificado por quatro olhos: alguém pede a revisão e outra pessoa admin verifica.
  • A organização define em quais workspaces cada nível de confiança roda; por padrão, agente não revisado não roda em nenhum.
  • Política de rede por agente: padrão da organização, nenhum destino ou lista de permitidos, com hosts e servidores MCP. A checagem acontece antes de executar, e o bloqueio fica registrado.
  • Kill switch: desligar cancela as execuções em andamento e as aprovações pendentes e impede execuções novas, no serviço, no motor e no banco.
  • Aprovação automática aparece na execução identificada como decisão da governança, não como decisão de uma pessoa.
Pela API da área logada Rotas usadas pela tela, com sessão do navegador: ajustar um agente, desligá-lo, religá-lo e acionar o kill switch da organização.
PUT /api/platform/agent-governance/agents/{ref}
{ autonomy?, networkMode?, networkAllowlist?, lowRiskTools?, maxAutoPerRun?, maxAutoPerDay?, trustTier?: 'unreviewed' }

POST /api/platform/agent-governance/agents/{ref}/kill     { reason? }
DELETE /api/platform/agent-governance/agents/{ref}/kill
POST /api/platform/agent-governance/kill

O que não faz

  • A governança só restringe: nunca amplia o que a versão do agente e as permissões de quem disparou permitem.
  • Agente importado sem revisão não usa ferramenta com efeito, em nenhum nível de autonomia.
  • Ferramenta que grava em nome de quem aprova nunca pode ser marcada como de baixo risco.
  • O orçamento padrão de ações sem aprovação é zero: sem o admin definir, tudo continua pedindo aprovação.

Agent operations

Execuções revisadas por pessoas viram casos, datasets e regras

Quem revisa marca cada execução como correta, errada ou duvidosa, com rótulos da taxonomia do workspace e o motivo. A execução concluída vira caso de avaliação com um clique, com credenciais e dados pessoais mascarados, e o conjunto anotado sai como dataset JSONL. O motivo pode virar documento no Knowledge, a memória compartilhada dos agentes.

O mesmo agente roda em ambientes com versão fixada e promoção (só versão aprovada na suíte), e a autonomia pode ser menor num ambiente ou para um time: vale sempre a mais restritiva. Agentes de fora mandam spans OpenTelemetry, que entram redigidos e se juntam às execuções da mesma sessão com o custo somado.

Como funciona

  • Anotação por execução, com taxonomia própria e memória de feedback no Knowledge.
  • Execução real vira caso de avaliação; dataset JSONL com máscara de dados pessoais.
  • Sessões e custo por ticket, juntando execuções internas e spans externos.
  • Ambientes com promoção e autonomia por ambiente e por time.
  • AI-BOM em CycloneDX 1.6, avaliações pela API v1 e por três ferramentas MCP com a chave agents:eval, e busca de código com acesso por repositório.
  • Fluxo que chama outro fluxo, uma vez ou em matriz (uma execução por item da lista, até 10 em paralelo), com profundidade limitada, e estratégia de falha por etapa.
Agente externo enviando spans e suíte no CI Qualquer SDK OpenTelemetry com o exportador OTLP HTTP em JSON serve; a chave tem o escopo agents:trace.
OTEL_EXPORTER_OTLP_PROTOCOL=http/json
OTEL_EXPORTER_OTLP_ENDPOINT=https://aiuby.com/api/v1/otel
OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer $AIUBY_TOKEN"

O que não faz

  • A autonomia por ambiente ou por time só restringe: nunca amplia a do agente.
  • A busca de código cobre até 400 arquivos de código por repositório, da branch padrão, e a chave de API só encontra repositório sem restrição.
  • Atributo de span com nome de credencial é descartado na entrada; o resto passa pela máscara de dado pessoal.

Workflows

Processos com várias etapas, com aprovação onde você colocar

Um fluxo liga etapas num desenho: agentes, busca no conhecimento, conectores, condições e aprovações. Você monta no canvas ou por formulário, testa o rascunho e publica; publicar valida o desenho e grava uma versão que não muda mais.

O fluxo começa por uma pessoa, por agenda, por API ou por outro fluxo. A aprovação humana é uma etapa do desenho: o conector que vem depois dela espera a decisão; o conector sem essa etapa antes roda direto, inclusive quando o fluxo é disparado por agenda.

Como funciona

  • Etapas: início, agente, base de conhecimento, conector, aprovação humana, condição, junção, executar outro fluxo e fim; de 2 a 5 agentes podem rodar em paralelo.
  • Agente dentro do fluxo roda a versão publicada pelo mesmo caminho de qualquer execução: Gateway, orçamento, limites, dado sensível e aprovação das ferramentas dele.
  • Conector chama só automação cadastrada no n8n do workspace, com os parâmetros definidos no fluxo e um disparo por passo.
  • Agenda por intervalo (de 15 minutos a 7 dias), diária ou semanal, rodando em nome de quem agendou; cada etapa escolhe se a falha encerra, segue como saída ou tenta de novo até 3 vezes.
  • A publicação recusa desenho com ciclo, etapa inalcançável, condição sem os dois ramos, agente sem versão publicada ou automação fora do cadastro, e a tela marca o que corrigir.
  • Cada execução guarda os passos, e criar, publicar, agendar, iniciar, aprovar e recusar ficam na auditoria.
Pela API Inicia um fluxo publicado que aceita gatilho por API e consulta a execução.
curl -sS -X POST "https://aiuby.com/api/platform/flows/$FLUXO_ID/runs" \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"input":"Pedido 4471: conferir e encaminhar","idempotencyKey":"pedido-4471"}'

curl -sS "https://aiuby.com/api/platform/flows/runs/$EXECUCAO_ID" -H "Authorization: Bearer $AIUBY_TOKEN"

O que não faz

  • Conector sem etapa de aprovação antes dele roda sem ninguém aprovar, inclusive por agenda: a etapa é escolha de quem desenha.
  • Fluxo sem gatilho por API publicado responde 409 a uma chave; a entrada tem até 20.000 caracteres.
  • Uma execução tem no máximo 60 passos e 25 horas; a aprovação pendente vence em 24 horas.
  • A agenda é sempre em UTC, e horários perdidos não se acumulam.

Evals

A versão que piorou não chega à produção

Cada agente tem uma suíte de casos de teste. Um caso diz a entrada e o que se espera: um texto que precisa aparecer, ferramentas que o agente deve usar, ferramentas que ele não pode usar e uma rubrica, que é o critério escrito pelo time.

A suíte roda contra uma versão do agente e um modelo faz o papel de juiz, dando a nota de cada caso pela rubrica. Sem avaliação aprovada, a versão não publica. A comparação entre duas versões mostra, caso a caso, o que regrediu.

Como funciona

  • Casos com texto esperado, ferramentas esperadas, ferramentas proibidas e rubrica.
  • Juiz por modelo: a nota segue o critério que o time escreveu, não um critério genérico.
  • Portão de publicação: a versão só publica com a avaliação aprovada.
  • Comparação de versões com as regressões destacadas, ao lado da diferença de instruções, modelo e ferramentas.
  • As soluções prontas trazem casos de partida, inclusive casos de tentativa de injeção de instrução.

Exemplo de uso

O time de atendimento muda as instruções do agente que responde sobre devolução. Antes de publicar, roda a suíte: quase todos os casos passam, e um falha porque a versão nova deixou de citar a política de troca. A comparação mostra o caso que regrediu, o time ajusta as instruções, roda de novo e só então a versão publica.

O que não faz

  • Avalia agentes da plataforma: não recebe agente que roda fora dela.
  • Cada agente tem até 20 casos.
  • Não desfaz sozinha uma versão publicada: voltar é publicar outra versão que passe no portão.

Prompt & config registry

O texto aprovado pela empresa, com versão e formulário

A biblioteca guarda os prompts do workspace como texto com variáveis tipadas: texto, texto longo, escolha, número e data. Cada prompt passa por rascunho, teste e publicação, e cada versão publicada não muda mais.

Quem usa não escreve prompt: preenche o formulário gerado das variáveis, pela tela, dentro do chat ou por API. A execução passa pelo Gateway, com modelo liberado, orçamento, limites e política de dado sensível, e o resultado vem com o custo.

Como funciona

  • Variáveis tipadas, descrição, modelo sugerido e etiquetas em cada versão.
  • Comparação de versões linha a linha, com as mudanças de descrição, modelo, etiquetas e variáveis.
  • Formulário validado na tela e de novo na API: campo obrigatório, opção da lista, número, data real e campo desconhecido recusado.
  • Edita quem configura agentes; membro usa só a versão publicada de prompt ativo.
  • Por API, com o escopo "Executar prompts": ler o formulário e executar com chave de idempotência; repetir a mesma chave devolve a mesma execução, sem nova cobrança.
  • Os valores preenchidos não são guardados; a saída, sim.
Pela API Lê o formulário da versão publicada e executa o prompt com os valores das variáveis.
curl -sS "https://aiuby.com/api/platform/prompts/$PROMPT_ID" -H "Authorization: Bearer $AIUBY_TOKEN"

curl -sS -X POST "https://aiuby.com/api/platform/prompts/$PROMPT_ID/runs" \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"values":{"cliente":"<nome do cliente>","tom":"consultivo"},"idempotencyKey":"proposta-001"}'

O que não faz

  • A execução é síncrona: não há aviso de conclusão para prompt.
  • Não compartilha prompt entre workspaces.
  • Chave de API executa só a versão publicada; rascunho é testado pela tela.

Knowledge bases

Respostas com o trecho e o documento de onde vieram

Cada workspace tem bases de documentos, com versão por documento. A busca devolve o trecho, o título, a base e a versão de onde ele saiu, e é com isso que o chat e os agentes respondem citando a fonte.

A permissão é por documento. Um documento restrito a determinadas pessoas só aparece para elas, e fica fora do resultado de uma busca feita por chave de API. O conteúdo de um documento é tratado como dado, nunca como instrução para o agente.

Como funciona

  • Formatos: texto e Markdown (até 5 MB), PDF com texto (até 20 MB) e CSV (até 2 MB, 20.000 linhas e 60 colunas).
  • Busca pela tela, pelos agentes, pela etapa de conhecimento dos fluxos e por API, com o escopo "Buscar no Knowledge".
  • Cada resultado traz trecho, título do documento, base, versão, posição e pontuação.
  • Envio por API com o escopo "Enviar documentos ao Knowledge": lista as bases e envia documentos ou versões novas.
  • Consulta de até 2.000 caracteres e até 20 resultados por busca.
Pela API Busca nos documentos do workspace; cada resultado vem com o trecho e a fonte.
curl -sS -X POST "https://aiuby.com/api/platform/knowledge/search" \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"query":"prazo de devolução","limit":5}'

O que não faz

  • Não lê PDF escaneado: não há OCR, e um PDF sem texto é recusado no envio.
  • Chave de API não cria base, não apaga documento e não lê o conteúdo inteiro de um documento.
  • Documento enviado por chave fica visível ao workspace inteiro; restringir a pessoas é só pela tela.
  • A fila de indexação aceita até 20 documentos pendentes por workspace.

Models & Gateway

Um endereço para todos os modelos, com regra e custo

O Gateway é a porta por onde passa toda chamada de modelo: as do seu código, as do chat, as dos agentes, dos prompts e dos fluxos. Antes de chamar o provedor, ele confere a chave, o modelo liberado, o orçamento, os limites por minuto e a política de dado sensível; depois, registra o uso e o custo.

A API segue o formato de chat da OpenAI, inclusive para modelos de outros provedores: o Gateway traduz a ida e a volta. Trocar de modelo é trocar um identificador, ou nem isso, quando o código usa o nome de uma rota do workspace.

Como funciona

  • Catálogo com modelos da Anthropic, da OpenAI, do Google Cloud e modelos abertos servidos pelo Google Cloud.
  • Liberação por workspace e restrição por papel, área e pessoa; modelo fora da lista responde 403.
  • Rotas: um apelido que aponta para um ou mais modelos, com reserva quando o primeiro falha ou fica sem orçamento.
  • Streaming no formato da OpenAI, com a política de dado sensível valendo também para o texto que vai chegando.
  • Cabeçalho de projeto para separar orçamento e relatório por aplicação.
  • Conexão da própria empresa com um provedor: o consumo é pago direto a ele, e as políticas e a auditoria continuam valendo.
Pela API Chat no formato da OpenAI com um modelo liberado no workspace da chave.
curl -sS -X POST "https://aiuby.com/api/gateway/v1/chat/completions" \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 512,
    "messages": [
      {"role": "system", "content": "Responda em português, em até três frases."},
      {"role": "user", "content": "O que é uma trilha de auditoria?"}
    ]
  }'

O que não faz

  • Os modelos rodam nos servidores dos provedores; o processamento pode acontecer fora do Brasil.
  • Não há rota pública de embeddings por chave de API.
  • A reserva só entra antes do primeiro pedaço da resposta: não há troca de modelo no meio de um stream.
  • O corpo da chamada tem até 4 MB, e um campo fora da lista aceita é recusado em vez de ignorado.

Skills registry

Skills revisadas por outra pessoa antes de chegar aos agentes de código

Um catálogo, por organização, das skills que os agentes de código do time usam (Claude Code, Cursor e semelhantes). Cada skill tem um nome único e versões; cada versão é o manifesto, o arquivo SKILL.md e o sha256 do conteúdo, e não muda depois de gravada.

A versão percorre rascunho, revisada, publicada e retirada. Quem escreveu não revisa: a regra de quatro olhos é conferida no servidor e no banco. Só versão publicada sai, pela API v1 ou pelo servidor MCP, e quem baixa confere o hash antes de instalar. A plataforma guarda, revisa e distribui; ela não executa skill.

Como funciona

  • Manifesto com nome, descrição, versão, dono, entradas, saídas, permissões declaradas e compatibilidade.
  • Versão nova precisa ser maior, em semver, que todas as existentes.
  • Escrever, revisar, publicar e retirar cabem a dono ou admin, e cada passo fica na auditoria.
  • Download com uma chave de escopo "Baixar skills publicadas"; sem informar a versão, vem a publicada mais alta.
  • Pelo servidor MCP, o tipo skill lista nome, dono, versões publicadas e sha256, e devolve o manifesto e o SKILL.md.
Pela API v1 Lista as skills publicadas, baixa uma versão e confere o sha256 do conteúdo.
curl -sS https://aiuby.com/api/v1/skills -H "Authorization: Bearer $AIUBY_TOKEN"
curl -sS "https://aiuby.com/api/v1/skills/revisar-pr?version=1.0.0" -H "Authorization: Bearer $AIUBY_TOKEN" > skill.json
# Confira o hash antes de instalar:
jq -r .data.content skill.json > SKILL.md
test "$(sha256sum SKILL.md | cut -d' ' -f1)" = "$(jq -r .data.sha256 skill.json)" && echo ok

O que não faz

  • A plataforma não executa skills: só guarda, revisa e distribui.
  • As permissões do manifesto são declaração de quem escreveu; a plataforma não concede nem impõe nada no agente de código.
  • A CLI da plataforma não tem comando de skills: o download é pela API v1 ou pelo servidor MCP.
  • Rascunho, versão revisada e versão retirada não saem pela API nem pelo MCP.

Execution traces

Cada execução aberta passo a passo, com custo e tempo

O trace é a execução vista por dentro: cada chamada de modelo, cada ferramenta usada, cada espera por aprovação e cada decisão de política vira um passo, com o custo e a latência daquele passo. Dá para ver onde o agente gastou, onde demorou e em que ponto parou, e o Assistente da plataforma pode ler a execução aberta (passos, erro, custo e saída) para responder sobre ela.

Execuções com a mesma chave de sessão, por exemplo o número de um ticket, aparecem juntas e em ordem, com o custo somado. Agentes que rodam fora da AIUBY entram no mesmo lugar: qualquer SDK OpenTelemetry com o exportador OTLP HTTP em JSON envia spans para /api/v1/otel/v1/traces com uma chave de escopo agents:trace, e os spans com a mesma sessão se juntam às execuções internas.

Como funciona

  • Passo a passo de cada execução de agente e de fluxo, com tipo, ferramenta, detalhe, custo e latência; custo ligado ao registro de consumo do Gateway.
  • Sessão por chave livre, definida na criação da execução ou depois, juntando agentes diferentes e spans externos.
  • Redação na entrada dos spans: atributo com nome de credencial é descartado, e o resto passa pela máscara de segredo e de dado pessoal.
  • Convenções gen_ai.* viram modelo e tokens; session.id agrupa o span na sessão; até 1.000 spans por chamada.
  • AI-BOM do workspace em CycloneDX 1.6, com agentes, versões publicadas, ferramentas, autonomia, ambientes e modelos.
  • Decisões de aprovação e de governança aparecem no ponto exato da execução em que aconteceram.

Exemplo de uso

Um time roda um agente de triagem fora da AIUBY e outro dentro dela, os dois atendendo o mesmo chamado. O agente de fora aponta o exportador OTLP para a AIUBY com uma chave de traces e marca o número do chamado como sessão; os agentes de dentro recebem a mesma chave. Na sessão do chamado, a pessoa responsável vê a ordem dos passos, onde a latência concentrou e o custo somado das execuções internas, sem nenhum token ou dado pessoal guardado.

O que não faz

  • É leitura: o trace não altera nem repete uma execução, e a chave de traces não lê nada.
  • Recebe só OTLP em JSON; protobuf não é aceito. Span externo traz modelo e tokens, sem custo calculado.
  • A plataforma não exporta os próprios traces em OpenTelemetry.
  • Uma chave de API só consulta as execuções que ela mesma iniciou.

IA e limites

O que a IA faz aqui, e o que nunca faz sozinha

Faz

  • Responde citando o documento de onde tirou a informação.
  • Executa os passos do agente ou do fluxo com as ferramentas liberadas para a versão.
  • Dá a nota dos casos de avaliação pelo critério que o time escreveu.
  • Nos agentes do catálogo, consulta e cita a evidência (especialistas) ou monta uma proposta para revisão (workers).

Não faz

  • Ferramenta com efeito de um agente não roda sem a aprovação de uma pessoa; a exceção é a ferramenta que o admin marcou como de baixo risco na governança, dentro do orçamento de ações que ele definiu.
  • Num fluxo, o conector roda sem aprovação, inclusive por agenda, se quem desenhou não colocou a etapa de aprovação antes dele.
  • Não usa modelo fora da lista liberada no workspace.
  • Não executa skill: o catálogo de skills só guarda, revisa e distribui.
  • É instruído a não seguir ordens que apareçam em documentos; isso reduz o risco, não o elimina, e ferramenta com efeito de agente continua dependendo de aprovação.

Governança e segurança

Regras que o código impõe

  • Modelos liberados por workspace e restritos por papel, área e pessoa.
  • Chaves de API com escopo por função (por exemplo, só buscar no conhecimento); nenhuma chave aprova ação de agente.
  • Orçamento por workspace e teto por organização; sem saldo, a chamada é recusada.
  • A ferramenta só roda se está na versão do agente e se quem disparou tem a permissão dela; quem aprova precisa da permissão de aprovador.
  • A aprovação vence em 24 horas, e ferramenta bloqueada pela política do workspace é recusada mesmo depois de aprovada.
  • Versões publicadas de agentes, prompts, fluxos e documentos não mudam.
  • Conteúdo de documento e resposta de ferramenta externa são tratados como dado, nunca como instrução.

Integrações

Com o que se conecta

Só integrações que existem no código. Cada uma leva o status da funcionalidade que a usa.

  • Anthropic, OpenAI e Google CloudProvedores de modelo ligados ao gateway.Models & Gateway
  • n8n da sua empresaFluxos chamam automações com retorno assinado.Workflows
  • Servidores MCPFerramentas da sua empresa, revisadas antes do uso.Agent Management
  • PostgresConsulta só de leitura a um banco da empresa.Agent Management
  • Claude Code e CursorAgentes de código baixam as skills publicadas e conferem o hash.Skills registry
  • Clientes MCPLeitura da engenharia e das skills publicadas pelo servidor MCP, com chave de API.MCP server
  • API e webhooksChat, busca no conhecimento e execução de agentes, prompts e fluxos por API.API, CLI & keys
  • OpenTelemetry (OTLP HTTP JSON)Agentes que rodam fora da AIUBY enviam spans, redigidos na entrada.Execution traces

Workflows

Fluxos: processos em blocos

Agentes, buscas na base, automações do n8n e aprovações humanas encadeados num desenho, com fluxos prontos para começar, versão publicada, agendamento e execução por API.

Ver como os fluxos funcionam
  • Início
  • Agente
  • Base de conhecimento
  • Conector (automação)
  • Aprovação humana
  • Condição
  • Junção
  • Resposta (fim com modelo)
  • Fim
  • Executar outro fluxo

Ferramentas

Dados de fora da base, com a fonte junto

Além da base de conhecimento, um agente pode consultar a cotação oficial do câmbio e um banco Postgres da empresa, só para leitura. As duas ferramentas devolvem a fonte com o resultado, e a falha volta como erro, nunca como número inventado.

  • dados abertos

    Câmbio PTAX do Banco Central

    Cotação de compra e venda pelos dados abertos do Banco Central, para 10 moedas (AUD, CAD, CHF, DKK, EUR, GBP, JPY, NOK, SEK, USD). Traz o último boletim e a última PTAX de fechamento, com data, hora e fonte; com uma data, a cotação mais recente até ela.

    • Só consulta: não pede aprovação, porque não tem efeito
    • Sem resposta do Banco Central, o agente diz que falta a cotação e não converte
  • opcional

    Conector Postgres somente leitura

    Quem administra o workspace cadastra o banco e escolhe as tabelas ou visões liberadas. O agente vê o catálogo dessas tabelas e faz uma consulta SELECT por vez, que roda numa transação só de leitura, com tempo máximo de 5 s e até 200 linhas e 50 colunas por resultado.

    • Consulta fora da lista de tabelas, com escrita ou com função fora da lista é recusada, com o motivo
    • Cada consulta vai para a auditoria com o SQL (dado sensível trocado por marcador), as linhas e a duração; nunca os dados
    • Senha cifrada; ninguém a vê depois do cadastro

Para usar o conector

  1. Postgres com endereço público e TLS
  2. Conexão liberada no firewall a partir da AIUBY
  3. Um usuário só com SELECT nas tabelas ou visões liberadas, sem superusuário
  4. Recomendado: réplica de leitura e visões só com as colunas necessárias

Limites das ferramentas

  • Só Postgres: MySQL, SQL Server, ERP e ferramentas de BI não têm conector.
  • Banco só na rede interna, sem endereço público, não é alcançado.
  • A validação do SQL é uma barreira a mais; a barreira que vale é o usuário só com SELECT exigido do cliente.
  • Uma consulta pesada usa CPU e memória do banco do cliente por até 5 s.

Perguntas frequentes

Respostas diretas

O que já dá para usar hoje?

Disponível: Agent Management, Specialist & worker agents, Agent governance, Agent operations, Workflows, Evals, Prompt & config registry, Knowledge bases, Models & Gateway, Skills registry, Execution traces. Contratação pela conta, em autoatendimento.

Preciso ter conta nos provedores de modelo?

Não. O consumo passa pela conta da AIUBY e sai do saldo pré-pago em reais. Se preferir, a conexão da própria empresa com um provedor também funciona; aí o consumo é pago direto a ele.

Um agente pode agir sem ninguém aprovar?

Disponível: Agent Management, Agent governance, Workflows. Por padrão, não: ferramenta com efeito de um agente para e espera a decisão de uma pessoa, e agentes que só leem e respondem não precisam de aprovação. Na governança de agentes, o admin pode dispensar a aprovação só para ferramentas que ele marcou como de baixo risco, com orçamento de ações por execução e por dia; isso vem desligado, e o kill switch desliga um agente ou todos de uma vez. Fluxos são diferentes: a aprovação é uma etapa que quem desenha coloca antes do conector, e um fluxo sem essa etapa aciona o seu n8n direto, inclusive por agenda.

Dá para usar a avaliação como portão no CI?

Disponível: Evals, Agent operations. Sim, pela API v1: com uma chave de escopo agents:eval, o pipeline lista e cria casos, roda a suíte de um agente numa versão e lê o resultado; as mesmas operações existem como ferramentas do servidor MCP. Execuções reais revisadas por pessoas também viram casos da suíte, com dados pessoais mascarados.

Os agentes especialistas e os workers aplicam mudanças?

Disponível: Specialist & worker agents. Não. Os especialistas só leem e respondem citando a evidência; os workers só propõem, e a proposta é decidida por outra pessoa, nunca por quem disparou a execução. Cada um tem teto de passos, de custo e de tempo.

Tem rastreamento com OpenTelemetry?

Disponível: Agent Management, Execution traces. Na entrada, sim. Cada execução de agente mostra os passos com custo e latência, e execuções com a mesma chave de sessão aparecem juntas com o custo somado. Agentes que rodam fora da AIUBY mandam spans pelo exportador OTLP HTTP em JSON, com uma chave de escopo agents:trace; atributo com nome de credencial é descartado e o resto passa pela máscara de dado pessoal. A plataforma não exporta os próprios traces em OpenTelemetry.

Onde ficam meus documentos e conversas?

Documentos, trechos indexados e conversas ficam na plataforma, com permissão por documento. A plataforma e o banco de dados são hospedados pela AIUBY. As organizações compartilham o banco, e cada uma só enxerga as próprias linhas, por regra de acesso aplicada linha a linha. O backup diário sai cifrado para a AWS, nos Estados Unidos. As chamadas de modelo vão ao provedor escolhido, que pode processar fora do Brasil. Se a organização for encerrada, documentos, conversas, agentes, fluxos, prompts e integrações são apagados em 30 dias; auditoria, consumo e faturas continuam guardados.

Quanto custa?

Disponível: Knowledge bases, Agent Management. Knowledge bases e o conjunto de agentes, fluxos, avaliações e prompts têm mensalidade por faixa, cada um no seu contrato. O consumo de IA é à parte e sai do saldo pré-pago em reais. Os valores estão em Preços.

Funciona junto com

  • AI & API SecurityA política de dados sensíveis age antes de cada chamada de modelo.
  • Cost ManagementO custo de cada execução aparece por modelo, chave e projeto.
  • Code AutomationOs workers do catálogo de agentes entregam propostas de mudança de código para revisão humana.

AI Engineering

Contratação pela conta, em autoatendimento.