Sobre o projeto

O Known Agents SDK é um cliente oficial Node.js para interagir com a plataforma Known Agents. Ele permite que aplicativos server‑side TypeScript ou JavaScript coletem análises detalhadas sobre agentes AI e outros bots que visitam um site ou chamam endpoints do Model Context Protocol (MCP). Principais recursos: * **Rastreamento de eventos de visita** – Use `trackPageviewOrRESTCall` em middleware para registrar visualizações de página ou chamadas REST. Os eventos são enfileirados e automaticamente enviados com base no tamanho ou intervalo de tempo. * **Rastreamento de chamadas MCP** – Para serviços construídos sobre o Model Context Protocol, `trackMCPCall` registra a solicitação, a resposta e os detalhes de transporte, tratando automaticamente as interações do Agentic Commerce Protocol (ACP) e do Universal Commerce Protocol (UCP). * **Suporte a comércio agente** – Ao processar respostas REST de ACP ou UCP, inclua o corpo da resposta em `trackPageviewOrRESTCall` para capturar dados do fluxo de compra. * **Geração automática de robots.txt** – Chame `generateRobotsTXT` com uma lista de valores `AgentType` para obter um arquivo robots.txt em texto simples que bloqueia ou permite categorias específicas de rastreadores. A string pode ser regenerada em um cronograma (por exemplo, diariamente) e servida em `/robots.txt`. * **API de Identificação de Agentes** – Identifique e verifique solicitações de entrada usando `identifyAgent` (solicitação única) ou `identifyAgents` (lote). A resposta inclui status de verificação, metadados do agente, informações de ASN e uma pontuação de automação indicando a probabilidade de a solicitação ser automatizada. A instalação é simples via npm: `npm install @knownagents/sdk`. Após se cadastrar em knownagents.com e obter um token de acesso, instancie o cliente com `new KnownAgents('YOUR_ACCESS_TOKEN')`. Uma configuração opcional permite definir `flushQueueSize` e `flushIntervalInMilliseconds` para o loteamento de eventos. O SDK requer TypeScript ≥ 4.7 e roda no Node.js 18 LTS ou superior. Para ajuda, abra um issue no repositório GitHub. Em resumo, a biblioteca oferece uma solução abrangente do lado do servidor para análises de agentes AI, gerenciamento de tráfego de bots e tratamento automatizado de robots.txt, facilitando o monitoramento e controle das interações orientadas por AI com seus serviços web.