Pular para o conteúdo
NextPDF

NextPDF Connect

Visão geral

Seção intitulada “Visão geral”

O NextPDF Connect é o pacote nextpdf/server. Ele roda como um serviço de longa duração que expõe o motor de PDF 2.0 do NextPDF a agentes de inteligência artificial (AI) e a clientes Hypertext Transfer Protocol (HTTP). O mesmo registro de ferramentas fica disponível por três transportes: Model Context Protocol (MCP) sobre entrada e saída padrão, uma Application Programming Interface (API) Representational State Transfer (REST) descrita por um documento OpenAPI 3.1 e gRPC definido pelo pacote Protocol Buffers nextpdf.connect.v1. Cada ferramenta declara um nível de risco. As ferramentas do nível mais alto devem passar por um gate de confirmação human-in-the-loop (HITL) antes da execução.

Use esta seção quando você for operar ou integrar o servidor. Comece pela Visão geral para entender a arquitetura, escolha um transporte e, em seguida, use a referência da API para consultar os símbolos exatos de ferramentas e serviços.

Mapa da seção

Seção intitulada “Mapa da seção”

Estas páginas cobrem os conceitos, a configuração e as operações do servidor.

PáginaUse para
Visão geralEntender o limite do pacote, os três transportes e por que a contagem de ferramentas é uma propriedade de tempo de execução.
Início rápidoExecutar um primeiro handshake MCP e a requisição de renderização REST correspondente.
ConfiguraçãoConfigurar o arquivo YAML do MCP, as variáveis de ambiente NEXTPDF_* e a substituição de risco limitada à elevação.
Inicialização e descobertaVer como cada transporte conecta o servidor e descobre ferramentas e níveis na inicialização.
Catálogo de ferramentasVer o conjunto verificado de ferramentas principais, sempre disponível, e como o tempo de execução calcula a contagem total.
Níveis de risco HITLEntender o modelo de risco de quatro níveis e o desafio de confirmação para ferramentas que exigem aprovação.
ImplantaçãoConfigurar perfis de worker do RoadRunner, Docker, armazenamentos baseados em Redis e Transport Layer Security (TLS) mútuo do gRPC.
Segurança e operaçõesRevisar autenticação, segurança de transporte, modelo de ameaças e a postura de residência de dados.

Cada transporte tem sua própria página de referência.

Página de transporteUse para
Transporte MCPO enquadramento JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0 sobre stdio e os métodos initialize / tools/list / tools/call.
Transporte RESTO pipeline PSR-15 do RoadRunner, o contrato OpenAPI 3.1, a autenticação bearer e as rotas controladas por nível.
Transporte gRPCO serviço nextpdf.connect.v1.NextPDFConnect, as RPCs de streaming do servidor e a autenticação por metadados.

APIs principais

Seção intitulada “APIs principais”

Use estas duas páginas quando você for desenvolver para o servidor.

PáginaFunção
Referência da APIConsultar cada ferramenta registrada por nome e classe, os símbolos de serviço e mensagem do gRPC, o modelo de erro e os limites de taxa.
Guia do desenvolvedorEntender o limite da arquitetura, o ciclo de vida em tempo de execução, a resolução de níveis, o gate de confirmação, os pontos de extensão e a lista de verificação de testes.

Veja também

Seção intitulada “Veja também”