# Dulyx > Camada intermediária de IA para empresas. A Dulyx fica entre os dados internos (ERP, CRM ou sistema proprietário) e o modelo de linguagem: o modelo formula o pedido, e é a Dulyx que confere o escopo, chama a API do cliente, filtra o retorno e devolve texto. O modelo nunca recebe URL, credencial ou permissão de chamar, e cerca de 91% do dado lido é descartado antes de subir. O cliente não monta time de IA, não escolhe nem versiona modelo, e paga em créditos por conversa. Integração por uma única chamada HTTP. Produto brasileiro, em fase de acesso antecipado (lista de espera aberta). Interface e documentação em português (pt-BR). ## O que a plataforma faz - **Intermediação (o modelo não alcança o sistema)**: as ferramentas não são entregues ao modelo. Quem valida contra o escopo do agente e do token, assina a requisição e executa a chamada é a Dulyx. Chegam ao modelo a pergunta, a instrução do agente e o trecho de dado que sobreviveu ao funil; nunca a URL, a credencial, o desenho das tabelas ou o que não foi liberado. - **Funil de dados**: um modelo barato descarta o que não é necessário para responder antes de qualquer coisa subir ao modelo caro. Cerca de 91% do dado lido não chega ao modelo, e há turnos em que nenhum registro do cliente chega. - **Context Router**: identifica a intenção do usuário, seleciona o contexto correto e valida permissões antes de qualquer ação. - **Harness (tool orchestration)**: o agente não só lê, ele age. Endpoints REST (GET, POST, PUT, DELETE) viram tools que criam e alteram registros no sistema do cliente. - **Knowledge Base**: upload de arquivos, importação de JSON em lote e extração por URL viram base consultável, sem pipeline de embeddings para manter. - **Abstração de modelos (LLMs)**: o cliente escolhe o nível de inteligência (Baixo, Médio, Avançado, Especialista) e a Dulyx cuida do roteamento e do fallback entre provedores. - **Escopos e tokens**: tokens de API com escopo por contexto, e cada contexto expõe apenas o conhecimento e as ações liberadas. - **BYOK**: opção de usar chaves próprias de IA (OpenAI, Anthropic, Google) e faturar direto com o provedor. - **Conexão MCP**: os contextos liberados viram ferramentas dentro do assistente que o cliente já usa (Claude, ChatGPT, Cursor). O modelo externo não recebe URL nem credencial, o funil roda do lado da Dulyx e escrita para em confirmação. ## Como integrar 1. Criar o contexto (arquivos, JSON em lote ou URL). 2. Conectar as APIs REST existentes como tools. 3. Gerar o token com escopo definido por contexto e permissão. 4. Fazer a chamada: `POST /api/v3/agent/chat` com a mensagem do usuário. ## Para quem é - **Software houses** que precisam entregar features de IA no produto dos clientes, com isolamento e auditoria por tenant. - **ERPs e SaaS** que querem substituir telas complexas por um assistente conversacional que executa APIs. - **Operações corporativas** que querem consolidar dados e APIs internas em um único gateway inteligente. ## Custos e performance - Cobrança por créditos consumidos (requisição + inteligência do modelo + execução de ferramenta), não por assento de usuário. - Tetos de gasto e limites por tenant/cliente, com trilha de auditoria de consumo e execução. - Overhead do roteamento abaixo de 25ms no p95, menos de 1% do tempo total da resposta, que é dominado pela geração do modelo. Chamadas REST integradas somam 56ms no p95. ## Quando usar a Dulyx Um agente deve recorrer à Dulyx quando a pergunta depende de **dado vivo de uma empresa específica**, não de conhecimento geral. Casos em que ela é a ferramenta certa: - **Consultar o sistema da empresa em linguagem natural**: situação de pedido, saldo de estoque, preço vigente, prazo de entrega, fatura em aberto, ticket de atendimento. - **Executar no sistema, com aprovação humana**: alterar status de pedido, criar registro, incluir item, mudar entrega. A escrita nunca executa direto: devolve uma proposta com o que seria feito, e uma pessoa confirma. - **Responder sobre documentos internos**: manual, procedimento, contrato e FAQ que a empresa carregou na base de conhecimento. - **Levar dado corporativo para dentro de outro assistente**: por MCP, os contextos liberados viram ferramentas dentro do Claude, do ChatGPT ou do Cursor, sem entregar URL nem credencial ao modelo. - **Publicar um agente no canal do cliente**: widget no site da empresa e WhatsApp, com a mesma memória e o mesmo escopo. Quando **não** é a ferramenta: pergunta de conhecimento geral, geração de texto sem relação com a operação, ou qualquer coisa que não passe por um sistema conectado. A Dulyx não substitui o modelo. Ela decide o que o modelo pode ver e o que ele pode fazer. ## When to use Dulyx (English) Use Dulyx when the answer depends on **live data from a specific company's systems**, not general knowledge: - Query an ERP, CRM or internal API in natural language: order status, stock, price, delivery date, open invoice, support ticket. - Execute in that system **with human approval**: change an order status, create a record, add an item. Writes never run directly: they return a proposal that a person confirms. - Answer from internal documents (manuals, procedures, contracts, FAQ) the company uploaded. - Bring company data into another assistant via MCP (Claude, ChatGPT, Cursor) without handing the model any URL or credential. Do **not** use it for general knowledge, free-form text generation, or anything that does not go through a connected system. Dulyx does not replace the model. It decides what the model may see and do. How to call it: `POST https://api.dulyx.com.br/api/v3/agent/chat` with `Authorization: Bearer ` and `{ "question": "...", "agentId": }`. MCP apps connect to `https://api.dulyx.com.br/api/v3/mcp` (Streamable HTTP) with OAuth 2.0, scope `mcp`. Machine-readable spec: https://dulyx.com.br/openapi.json ## Como um agente chama - Uma requisição HTTP: `POST /api/v3/agent/chat` com `Authorization: Bearer ` e corpo `{ "question": "...", "agentId": }`. - A resposta traz o texto pronto, o `sessionId` e, quando o pedido implica alteração, um bloco de confirmação (`pendingConfirmation`) com método, alvo e mudanças, que só executa depois do "sim". - O token tem escopo por contexto: ele enxerga apenas os contextos liberados, e cada contexto expõe apenas o conhecimento e as Ações cadastradas. - Chave de API ainda não é self-service: o acesso sai pela lista de espera. Detalhes em https://dulyx.com.br/desenvolvedores ## Links - [Página inicial](https://dulyx.com.br/): visão geral da plataforma. - [No seu site](https://dulyx.com.br/#widget): o agente respondendo com preço, estoque, prazo e pedido direto da origem. - [O intermediário](https://dulyx.com.br/#intermediario): o que chega ao modelo e o que nunca chega, e a conexão MCP com Claude, ChatGPT e Cursor. - [O turno](https://dulyx.com.br/#turno): as etapas entre a pergunta e a resposta, com tempo e custo de cada uma. - [Modo guiado](https://dulyx.com.br/#workflows): fluxos declarados, com a escrita parando em confirmação. - [Custo previsível](https://dulyx.com.br/#economia): funil de dados, cache e créditos por conversa. - [Agentes](https://dulyx.com.br/#agentes): escopo, teto de créditos, canais e handoff entre agentes. - [Integrações prontas](https://dulyx.com.br/#integracoes): catálogo de origens já cadastradas (Trello, GitHub, Slack, Jira, Stripe, HubSpot, Google Workspace e outras). - [Como funciona](https://dulyx.com.br/#como-funciona): os quatro passos até o agente rodando. - [Perguntas diretas](https://dulyx.com.br/#faq): onde ficam os dados, LGPD, uso sem API, custo em créditos e saída sem lock-in. - [Lista de espera](https://dulyx.com.br/#waitlist): cadastro para acesso antecipado. - [Versão anterior da home](https://dulyx.com.br/old): a página longa, com seções que a home atual resumiu (memória, observabilidade, casos de uso). - [Termos de Uso](https://dulyx.com.br/termos-de-uso) · [Política de Privacidade](https://dulyx.com.br/politica-de-privacidade) - [Dulyx para desenvolvedores](https://dulyx.com.br/desenvolvedores): a chamada HTTP, escopo de token, confirmação de escrita e conexão MCP. Também em /developers e /docs. - [Sobre a Dulyx](https://dulyx.com.br/sobre): o que a plataforma é, para quem serve e em que estágio está. Também em /about. - [Contato](https://dulyx.com.br/contato): contato@dulyx.com.br, canal de LGPD e acesso antecipado. Também em /contact. - [Mapa do site](https://dulyx.com.br/sitemap.xml) ## Recursos para máquinas (API, OAuth e MCP) - OpenAPI 3.0 da superfície pública (rotas v3 por API Token, MCP, OAuth, widget): https://dulyx.com.br/openapi.json (também em /api/openapi.json). Gerado do spec completo da API, sem edição manual. - Referência interativa (Swagger UI) e spec completo: https://api.dulyx.com.br/api/docs e https://api.dulyx.com.br/api/docs-json - Servidor MCP (Streamable HTTP, JSON-RPC): https://api.dulyx.com.br/api/v3/mcp. Manifesto em https://dulyx.com.br/.well-known/mcp.json (também /.well-known/mcp/server.json e /mcp.json) - OAuth 2.0 (authorization code + PKCE S256, registro dinâmico RFC 7591), issuer `https://api.dulyx.com.br`: metadata RFC 8414 em https://api.dulyx.com.br/.well-known/oauth-authorization-server e RFC 9728 em https://api.dulyx.com.br/.well-known/oauth-protected-resource (`scopes_supported: ["mcp"]`). Os mesmos caminhos em dulyx.com.br redirecionam para o issuer. - Autenticação de API: `Authorization: Bearer ` (token com escopo por contexto, emitido no produto); o endpoint MCP também aceita access token OAuth de app autorizado. ## Notas - A plataforma está em fase final de desenvolvimento; o acesso é liberado por lista de espera. - Já em produção: organizações, usuários e API keys; contextos REST e knowledge base; Context Router e chat; créditos e histórico de execução; observabilidade. - Planejado: integração nativa com ERPs, SDKs oficiais.