Para agentes

A Entradigm foi construída para agentes.

Todas as ações da interface têm um equivalente na API com esquema tipado. Isto não é uma integração acrescentada a posteriori, é a arquitetura: a superfície de agentes é a superfície principal, e a interface humana é uma fina camada por cima. Esta página dirige-se ao comprador humano — e ao mesmo tempo mostra a um agente exatamente onde vive a superfície legível por máquina.

Orientar, inspecionar, agir

Três chamadas — e duas delas não precisam de token algum.

Duas superfícies públicas vivem no anfitrião da aplicação, com CORS ativado e sem autenticação: o llm.txt em texto simples para orientação, e o esquema de intenções com o seu bloco de capacidades para introspeção — apenas documentação da plataforma e esquema público, nunca dados de inquilinos. Só a terceira chamada desencadeia um ciclo real.

As mesmas barreiras de um operador

Um agente recebe a API — não um atalho que salte a revisão.

As intenções de agente correm por um único endpoint, protegido por bearer token e com limite de taxa, com os mesmos orçamentos que o disparo na aplicação recebe — e todos os ciclos conduzidos por agentes continuam a parar para aprovação humana antes de qualquer publicação. O que está ativo hoje leva a etiqueta Ativo; a API pública versionada leva a etiqueta Objetivo de conceção.

Descoberta — ativa, sem autenticação

Duas superfícies públicas que um agente lê antes de tocar em qualquer coisa.

Ambas residem no anfitrião da aplicação app.entradigm.com, têm CORS ativado e não requerem autenticação. Contêm apenas documentação da plataforma e o esquema público — nunca dados de inquilinos.

GET https://app.entradigm.com/.well-known/llm.txt

Orientação (llm.txt)

Orientação em texto simples para agentes LLM: a documentação da plataforma em markdown, a lista de endpoints ativos e receitas curl prontas a copiar.

Abrir llm.txt →
GET https://app.entradigm.com/strategist/schema

Introspeção (esquema de intenções)

O esquema JSON legível por máquina de todas as intenções — formas de pedido, resposta, diapositivos e proveniência — mais o bloco de capacidades: apiVersion e sinalizadores live por intenção que indicam o que esta implementação consegue fazer. Legível a partir de qualquer origem.

Abrir esquema →

O protocolo

Orientar → inspecionar → agir — em três chamadas.

Os dois primeiros passos não requerem autenticação; o terceiro é protegido por bearer token e sujeito a limite de taxa — o agente passa o token do inquilino para desencadear um ciclo.

# 1. orient
curl -s https://app.entradigm.com/.well-known/llm.txt

# 2. introspect the capabilities block
curl -s https://app.entradigm.com/strategist/schema | jq '.capabilities.intents'

# 3. act (bearer-gated)
curl -s -X POST https://app.entradigm.com/strategist/run \
  -H "Authorization: Bearer $ENTRADIGM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":"generate-cycle","tenant":"your-tenant","cycleId":"2026-07-23-demo"}'

Em produção, POST /strategist/run espera adicionalmente a configuração do tenant passada inline como tenantConfig (opcional no esquema, exigida pelo runtime de produção) — consulte a forma do pedido no esquema acima.

Um agente externo — o seu fluxo n8n, o seu cenário Make, o seu agente de programação — conduz a Entradigm através do mesmo contrato com esquema tipado e da mesma barreira de revisão humana que um operador na interface: os ciclos desencadeados por agentes pausam para aprovação humana antes de qualquer publicação. Três outros endpoints públicos de esquema (/strategist/tools/schema, /memory/schema, /library/schema) estão indexados no llm.txt.

O que fazemos melhor

Uma superfície que um agente já pode ler hoje — e um contrato concebido para isso.

As capacidades ativas levam a etiqueta Ativo. As propriedades da futura API pública e versionada levam a etiqueta Objetivo de conceção — o caminho formal /v1/ está no roteiro abaixo.

Ativo

Descoberta sem autenticação

O llm.txt público e o esquema de intenções em /strategist/schema — legíveis a partir de qualquer origem, sem token.

Ativo

Intenções através de um único endpoint

As intenções de agente correm protegidas por bearer token e com limite de taxa através de /strategist/run — as mesmas barreiras, os mesmos orçamentos e a mesma revisão humana que o desencadeamento na aplicação.

Ativo

Matriz de capacidades legível por máquina

O bloco de capacidades no esquema diz a um agente o que esta implementação consegue fazer — sinalizadores live por intenção, plataformas suportadas e tipos de conteúdo — antes de ele tentar.

Objetivo de conceção

API versionada

A API pública está concebida para um caminho versionado (/v1/), para que o contrato não mude debaixo de um agente.

Objetivo de conceção

Envelope de erro unificado

A API pública devolverá os erros como {error:{code,message,context}} — legível por máquina e consistente, em vez de texto livre.

Objetivo de conceção

Paginação por cursor e cabeçalhos de limite de taxa

A API pública está concebida para percorrer listas através de cursores estáveis e transportar o orçamento restante em cada resposta através de cabeçalhos X-RateLimit-*. Payloads de webhook assinados para eventos de ciclo também fazem parte da visão-alvo.

Roteiro

O que vem a seguir para a superfície de agentes.

Cada um destes itens leva a sua etiqueta de roteiro em todas as superfícies que o mencionam. O contrato ativo acima é aquilo sobre o qual constrói hoje.

Roteiro 2027

Servidor MCP

Um único endpoint através do qual qualquer agente LLM integra a Entradigm como ferramenta, com introspeção total do esquema.

Roteiro

Nó n8n

Um nó nativo para fluxos de automação do n8n.

Roteiro

SKILL.md

Um manifesto de competências legível por agentes, para agentes de programação.

Roteiro

API pública /v1/

A API pública formal, versionada, com envelope de erro, paginação por cursor e cabeçalhos de limite de taxa.

Pronto?

Construa sobre uma plataforma que o seu agente consegue operar.