Aller au contenu

Intégration IA et Agents

fiskaly fournit un ensemble complet d’endpoints lisibles par machine et d’outils conçus pour les agents IA, les assistants de codage et les pipelines d’intégration automatisés. Cette section documente comment découvrir, interroger et intégrer les APIs fiskaly de manière programmatique — sans lire la documentation HTML.

Architecture

Section intitulée « Architecture »

Les agents IA interagissent avec fiskaly via un système de découverte en couches :

┌─────────────────────────────────────────────────┐
│  Discovery Layer                                │
│  llms.txt → CLAUDE.md → ai-plugin.json          │
├─────────────────────────────────────────────────┤
│  Structured Data                                │
│  products.json → regulatory.json                │
│  human-interventions.json                       │
├─────────────────────────────────────────────────┤
│  API Specifications                             │
│  9 OpenAPI specs (JSON/YAML)                    │
├─────────────────────────────────────────────────┤
│  Interactive Tooling                            │
│  MCP Server (search, specs, products, errors)   │
└─────────────────────────────────────────────────┘
  1. Découverte — llms.txt et ai-plugin.json informent les agents de ce qu’est fiskaly et où trouver des données structurées.
  2. Données structurées — products.json fournit des métadonnées produit lisibles par machine avec des URLs de base, des URLs de spécifications et des liens vers la documentation.
  3. Spécifications API — 9 spécifications OpenAPI couvrent tous les endpoints de tous les produits fiskaly.
  4. Outils interactifs — Le serveur MCP permet aux agents de rechercher de la documentation, de récupérer des spécifications et de consulter des codes d’erreur en temps réel.

Démarrage en tant qu’agent IA

Section intitulée « Démarrage en tant qu’agent IA »

  1. Récupérer l'index de découverte

    Commencez par https://workspace.fiskaly.com/llms.txt pour un index en texte brut de toute la documentation et des spécifications, ou par /CLAUDE.md pour un guide d’intégration structuré.

  2. Identifier le bon produit

    Interrogez https://workspace.fiskaly.com/products.json pour trouver le produit correspondant à votre pays cible. Chaque entrée inclut apiArchitecture, baseUrls et specUrl.

  3. Charger la spécification OpenAPI

    Récupérez l’URL de la spécification depuis le manifeste produit (par ex. /specs/sign-de-v2.json) pour obtenir les définitions complètes des endpoints, les schémas de requête/réponse et les détails d’authentification.

  4. Vérifier les étapes nécessitant une intervention humaine

    Interrogez /human-interventions.json pour identifier les étapes qui nécessitent un humain (création de compte, clés API, mise en production) et celles qui sont entièrement automatisables.

Contenu de cette section

Section intitulée « Contenu de cette section »

Serveur MCP

Configurez et utilisez le serveur MCP fiskaly-docs dans Claude Code, Cursor ou n'importe quel client MCP.

Endpoints Lisibles par Machine

Tous les endpoints de découverte et de données avec URLs, formats et exemples d'utilisation.

Bonnes Pratiques pour les Agents

Flux d'intégration recommandé, anti-patterns courants et particularités par pays.

Interventions Humaines

Quelles actions sont automatisables et lesquelles nécessitent un humain dans la boucle.

Was this page helpful?