Aftësi lokale për agjentët

Lidheni SCHNGN me agjentin tuaj

Instaloni mjedisin lokal, lidheni përmes MCP dhe shtoni aftësinë për planifikim të besueshëm të rregullit Schengen 90/180 ditë.

  • Llogaritje në proces lokal
  • Pa telemetri nga SCHNGN
  • JSON i rreptë dhe i versionuar
  • Rregulli i zakonshëm 90/180 ditë

SCHNGN nuk bën kërkesa dalëse. Pritësi i agjentit tuaj mund t’ia dërgojë përsëri hyrjet dhe rezultatet e mjeteve ofruesit të modelit.

02

Aftësia e agjentit

Aftësia i mëson agjentit kur të thërrasë SCHNGN, si të formojë intervale të qarta qëndrimi dhe kur të refuzojë pyetje për statusin ligjor.

Çfarë shton aftësia

  • Parapëlqen mjetet MCP në vend që të rindërtojë llogaritjen e datave.
  • I kufizon hyrjet te datat e hyrjes dhe daljes për qëndrime të vazhdueshme Schengen.
  • Qëndron brenda planifikimit të zakonshëm të qëndrimit të shkurtër dhe i drejton rastet e veçanta te autoritetet zyrtare.
03

Ndërfaqja

CLI

Përdorni JSON CLI në skripte dhe shell të agjentëve. Lexon JSON të rreptë nga stdin ose një skedar dhe kthen një rezultat JSON.

Komandat: schngn usage, schngn check-stay dhe schngn latest-exit.

schngn usage --input request.json
04

Ndërfaqja

REST + OpenAPI

Nisni një shërbim HTTP vetëm në loopback për mjetet REST. Ai ofron një dokument OpenAPI aktiv dhe refuzon adresat e lidhjes jo lokale.

OpenAPI: http://127.0.0.1:37491/openapi.json

schngn-api
05

Ndërfaqja

TypeScript

Importoni motorin e pastër për llogaritje bazë të datave ose paketën capability për kontratën e rreptë të agjentit.

Paketat: @schngn/engine dhe @schngn/capability

npm install @schngn/capability
import { calculateUsage } from '@schngn/capability';

const result = calculateUsage({
  stays: [{ entryDate: '2026-01-01', exitDate: '2026-01-12' }],
  referenceDate: '2026-02-01'
});
06

Referenca e mjeteve

Çdo ndërfaqe ofron të njëjtën kontratë llogaritjeje të versionuar. Datat përdorin YYYY-MM-DD dhe intervalet përfshijnë ditët e hyrjes dhe daljes.

01

calculate_schengen_usage

Hyrja
{ stays, referenceDate, includeCountedDays? }
Qëllimi
Llogarit ditët e përdorura dhe të mbetura në një datë reference të qartë.
02

check_schengen_stay

Hyrja
{ existingStays, candidateStay }
Qëllimi
Kontrollon çdo ditë të një qëndrimi të vazhdueshëm të propozuar.
03

latest_safe_schengen_exit

Hyrja
{ existingStays, entryDate }
Qëllimi
Gjen daljen më të fundit të sigurt për një qëndrim me datë hyrjeje të njohur.
07

Kufiri i privatësisë

Kufiri i llogaritjes është lokal, por rruga e plotë e agjentit mund të përfshijë shërbime cloud.

LOCAL

Mjedisi SCHNGN

Mjedisi nuk ruan të dhëna, nuk dërgon telemetri, nuk regjistron datat e dorëzuara dhe nuk bën kërkesa rrjeti dalëse.

HOST

Pritësi i agjentit dhe ofruesi i modelit

Klienti MCP ose pritësi i agjentit mund t’i dërgojë udhëzimet, argumentet e mjeteve dhe rezultatet ofruesit të modelit. Kontrolloni politikat e privatësisë dhe ruajtjes para se të përdorni data reale udhëtimi.

Kërkesat

Node.js 24 ose më i ri. Për llogaritjen nuk kërkohet llogari SCHNGN, çelës API, endpoint i hostuar ose lidhje rrjeti.

Fusha dhe kufizimet

Kjo aftësi modelon qëndrime të qarta të vazhdueshme sipas rregullit të zakonshëm Schengen 90/180 ditë. Nuk klasifikon shtete, nuk vendos për të drejta vize ose qëndrimi, nuk zbaton marrëveshje dypalëshe dhe nuk jep këshillë ligjore.

Vetëm ndihmë për planifikim. Autoritetet kompetente vendosin qëndrimin e lejuar.