html ❓ FAQ | Nullcore
Pule para o conteúdo principal

❓ FAQ

🌐 P: Por que meu servidor de ferramentas OpenAPI local não está acessível a partir da interface webui?

UM:Se o seu servidor de ferramentas estiver em execução localmente (por exemplo,http: // localhost: 8000), os clientes baseados no navegador podem ser impedidos de acessá-lo devido a políticas de CORS (compartilhamento de recursos de origem cruzada).

Certifique -se de ativar explicitamente os cabeçalhos CORS em seu servidor OpenAPI. Por exemplo, se você estiver usando o FASTAPI, pode adicionar:

deFASTAPImiddlewarecorsimportarCorsmiddleware

Appadd_middleware
Corsmiddleware, Assim,
allow_origins[[, Assim,  # ou especifique a origem do seu cliente
allow_credentialsVerdadeiro, Assim,
allow_methods[[, Assim,
allow_headers[[, Assim,

Além disso, se o Nullcore for servido por HTTPS (por exemplo,https://yourdomain.com), seu servidor local deve atender a uma das seguintes condições:

  • Ser acessado do mesmo domínio usando HTTPS (por exemplohttps: // localhost: 8000
  • Ou execute no localhost (127.0.0.1) para permitir que os navegadores relaxem a segurança para o desenvolvimento local.
  • Caso contrário, os navegadores podem bloquear solicitações inseguras das páginas HTTPS para as APIs HTTP devido a regras de conteúdo misto.

Para trabalhar com segurança na produção sobre o HTTPS, seus servidores OpenAPI também devem ser servidos pelo HTTPS.

🚀 P: Preciso usar o FASTAPI para a implementação do meu servidor?

UM:Não! Embora nossas implementações de referência sejam escritas usando o FASTAPI para maior clareza e facilidade de uso, você pode usar qualquer estrutura ou idioma que produz uma especificação válida do OpenAPI (Swagger). Algumas opções comuns incluem:

  • FASTAPI (Python)
  • Flask + Flask-Restx (Python)
  • Express + Swagger UI (JavaScript/Nó)
  • Botagem de primavera (Java)
  • Vá com ganhos ou eco

A chave é garantir que seu servidor exponha um esquema OpenAPI válido e que ele se comunique sobre HTTP (s). É importante definir um operação personalizada para todos os pontos de extremidade.

🚀 P: Por que escolher o OpenAPI em vez do MCP?

UM:O OpenAPI vence sobre o MCP na maioria dos cenários do mundo real devido à sua simplicidade, ecossistema de ferramentas, estabilidade e compatibilidade de desenvolvedores. Aqui está o porquê:

  • Reutilize seu código existente: Se você já construiu APIs de REST antes, está pronto - você não precisa reescrever sua lógica. Basta definir uma especificação OpenAPI compatível e expor seu código atual como um servidor de ferramentas.

    Com o MCP, você teve que reimplementar sua lógica de ferramenta dentro de uma camada de protocolo personalizada, duplicando o trabalho e aumentando a área de superfície para manter.

  • Menos para manter e depurar: OpenApi se encaixa naturalmente nos fluxos de trabalho modernos de desenvolvimento. Você pode testar pontos de extremidade com o Postman, inspecionar logs com APIs embutidas, solucionar problemas facilmente com ferramentas de ecossistema maduro-e muitas vezes sem modificar seu aplicativo principal.

    O MCP introduziu novas camadas de transporte, análise de esquema e peculiaridades de tempo de execução, todas as quais tiveram que ser depuradas manualmente.

  • Baseado em padrões: O OpenAPI é amplamente adotado em toda a indústria de tecnologia. Sua estrutura bem definida significa ferramentas, agentes e servidores podem interoperar imediatamente, sem precisar de pontes ou traduções especiais.

  • Melhores ferramentas: Existe um universo inteiro de ferramentas que suportam o OpenAPI - geração automática de clientes/servidores, documentação, validação, zombaria, teste e até ferramentas de auditoria de segurança.

  • Suporte de segurança de primeira classe: O OpenAPI inclui suporte nativo para coisas como OAuth2, JWTS, API Keys e HTTPs - tornando mais fácil criar pontos de extremidade seguros com bibliotecas e padrões comuns.

  • Mais desenvolvedores já sabem disso: Usar o OpenAPI significa que você está falando um idioma já familiar para equipes de back -end, desenvolvedores de front -end, DevOps e engenheiros de produtos. Não há curva de aprendizado ou integração cara necessária.

  • Future-Profper e extensível: O OpenAPI evolui com os padrões da API e permanece compatível com a frente. O MCP, por outro lado, foi sob medida e experimental - geralmente exigindo mudanças à medida que o ecossistema circundante mudou.

🧵 Conclusão: o OpenAPI permite fazer mais com menos esforço, menos duplicação de código e menos surpresas. É uma rota pronta para a produção e amiga dos desenvolvedores para as ferramentas Powering LLM-sem reconstruir tudo do zero.

🔐 P: Como faço para proteger meu servidor de ferramentas OpenAPI?

UM:O OpenAPI suporta mecanismos de segurança padrão da indústria como:

  • OAuth 2.0
  • Cabeçalhos -chave da API
  • JWT (JSON Web Token)
  • Auth Basic

Use https na produção para criptografar dados no trânsito e restringir os pontos de extremidade com os métodos Auth/Authz adequados, conforme apropriado. Você pode incorporá -los diretamente ao seu esquema OpenAPI usando o campo SecuritySchemes.

❓ P: Que tipo de ferramentas posso construir usando servidores de ferramentas OpenAPI?

UM:Se puder ser exposto através de uma API REST, você pode construí -la. Os tipos de ferramentas comuns incluem:

  • Operações do sistema de arquivos (leitura/gravação, diretórios de listagem)
  • Acesso ao repositório Git e Document
  • Consulta de banco de dados ou exploração de esquema
  • Raspadores da web ou resumos
  • Integrações externas de SaaS (por exemplo, Salesforce, Jira, Slack)
  • LLM ATRAVÉS DE MEMÓRIA ATRAVÉS
  • Microsserviços internos seguros expostos ao seu agente

🔌 P: Posso executar mais de um servidor de ferramentas ao mesmo tempo?

UM:Absolutamente. Cada servidor de ferramentas é executado de forma independente e expõe seu próprio esquema OpenAPI. Sua configuração de agente pode apontar para vários servidores de ferramentas, permitindo misturar e combinar com base na necessidade.

Não há limite - verifique se cada servidor é executado em sua própria porta ou endereço e é acessível pelo host do agente.

🧪 P: Como testo um servidor de ferramentas antes de vinculá -lo a um agente LLM?

UM:Você pode testar seus servidores de ferramentas OpenAPI usando:

  • Swagger Ui ou Redoc (incorporado em FASTAPI por padrão)
  • Postman ou insônia
  • Curl ou httpie da linha de comando
  • Módulo de solicitações do Python
  • Validadores e zombadores do OpenAPI

Uma vez validado, você pode registrar o servidor de ferramentas com um agente LLM ou através do Nullcore.

🛠️ P: Posso estender ou personalizar os servidores de referência?

UM:Sim! Todos os servidores nos servidores/ diretórios são criados para serem modelos simples. Bifurque e modifique -os para:

  • Adicione novos terminais e lógica de negócios
  • Integrar autenticação
  • Alterar formatos de resposta
  • Conecte -se a novos serviços ou APIs internas
  • Implante via Docker, Kubernetes ou qualquer host em nuvem

🌍 P: Posso executar servidores de ferramentas OpenAPI em plataformas em nuvem como AWS ou GCP?

UM:Sim. Esses servidores são serviços HTTP simples. Você pode implantá -los como:

  • AWS Lambda com API Gateway (sem servidor)
  • Instâncias de mecanismo de computação EC2 ou GCP
  • Serviços Kubernetes em GKE/EKS/AKS
  • Run ou mecanismo de aplicativo em nuvem
  • Renderizar, ferroviário, heroku, etc.

Apenas verifique se eles estão configurados com segurança e acessíveis publicamente (ou vpn'd), se necessário pelo agente ou usuário.

🧪 P: E se eu tiver um servidor MCP existente?

UM:Boas notícias! Você pode usar nossa ponte MCP para abertura:McPo, expor suas ferramentas baseadas em MCP existentes como APIs compatíveis com o OpenAPI agora é mais fácil do que nunca. Sem reescritas, sem dores de cabeça - basta conectar e ir! 🚀

Se você já criou ferramentas usando o protocolo MCP,mcpoAjuda você a desbloquear instantaneamente a compatibilidade com o Nullcore e qualquer agente baseado em OpenAPI-garantindo que seu trabalho duro permaneça totalmente acessível e pronto para o futuro.

Confira a ponte opcional para a seção MCP nos documentos para obter instruções de configuração.

Início rápido:

UVX MCPO --PORT 8000-UVX MCP-Server-Time-Local-timeZone = America/New_york

✨ É isso-seu servidor MCP agora está aberto!

🗂️ P: Um servidor OpenAPI pode implementar várias ferramentas?

UM:Sim. Um único servidor OpenAPI pode oferecer vários recursos relacionados agrupados em diferentes pontos de extremidade. Por exemplo, um servidor de documentos pode fornecer pesquisa, upload, OCR e resumo - tudo em um esquema.

Você também pode modularizar completamente criando um servidor OpenAPI por ferramenta se preferir isolamento e flexibilidade.

🙋 Tem mais perguntas? Visite as discussões do Github para obter ajuda e feedback da comunidade:
Discussões da comunidade