Cartographie des connaissances publiques de DOCA

Par où commencer : Utilisez cette skill quand la question est « où se trouve la réponse faisant autorité ? » — une page de documentation, la disposition de l'installation sur disque, un exemple, ou une entrée du catalogue NGC. Lisez d'abord ## Points d'accès à la documentation publique ; puis allez à la section table de routage qui correspond à l'intention de l'utilisateur.

Quand charger cette skill

Chargez cette skill chaque fois que l'utilisateur pose une question sur NVIDIA DOCA où l'agent doit localiser des informations faisant autorité sans accès à l'arborescence source de DOCA. Cela inclut : installer DOCA, compiler un exemple, apprendre une bibliothèque DOCA (Flow, DPA, Comm Channel, GPUNetIO, …), déboguer une erreur, trouver une référence API, trouver un exemple, trouver les notes de version, ou orienter l'utilisateur vers le forum des développeurs.

Cette skill est intentionnellement une table de routage, pas un tutoriel. Choisissez l'entrée qui correspond à l'intention de l'utilisateur, récupérez l'URL ou inspectez le chemin d'installation local, et seulement alors répondez.

Découverte au premier contact — les quatre questions à poser avant tout approfondissement

Quand un utilisateur ouvre avec une question d'orientation ouverte (« Je suis nouveau avec DOCA, comment commencer ? », « Pouvez-vous me guider ? », « Quel est le moyen le plus facile d'essayer DOCA ? »), l'agent n'a pas encore assez d'informations pour choisir un chemin. Poser ces quatre questions avant d'approfondir évite de faire des recommandations futiles que l'utilisateur ne peut pas réellement exécuter sur sa configuration. Posez-les dans un seul message court ; ne posez pas une question à la fois.

Question	Pourquoi c'est important	Ce qu'elle route
1. Sur quel OS êtes-vous ? macOS, Windows, ordinateur portable Linux, VM cloud, serveur Linux de labo, BlueField OS lui-même ?	DOCA s'installe nativement uniquement sur les distributions Linux supportées ; les utilisateurs macOS / Windows ne peuvent pas l'installer du tout.	Choisit parmi les quatre chemins d'acquisition de DOCA dans `doca-setup ## no-install`. macOS / Windows / pas de Linux → Chemin 0 (conteneur NGC). Linux supporté → Chemin A ou B selon le Guide d'installation.
2. Quel matériel avez-vous ? Pas de matériel NVIDIA, SmartNIC ConnectX, BlueField en tant que SmartNIC dans un hôte, BlueField en tant que DPU autonome, pas sûr ?	L'exécution avec trafic réel nécessite une vraie NIC ; la compilation / lecture / apprentissage ne le nécessite pas. Le matériel de l'utilisateur détermine quelles bibliothèques DOCA sont pertinentes.	Choisit l'histoire du runtime (le conteneur est build-only sans matériel). Filtre quelles bibliothèques ont du sens pour apprendre (Flow a besoin d'un port réel pour faire quelque chose de visible ; Comch a besoin d'une paire hôte ↔ DPU).
3. Quel est votre objectif ? Juste explorer, compiler une petite première app sur une bibliothèque spécifique (Flow / RDMA / Comch / Telemetry / GPUNetIO / DPA / …), exécuter une application de référence existante, exploiter un service (DMS / DTS / BlueMan / Firefly), ou autre chose ?	Le workflow de la première app du bundle (`doca-programming-guide ## modify`) démarre à partir d'un exemple C fourni et l'édite. Le bon exemple dépend de la bibliothèque ciblée par l'utilisateur.	Choisit quelle skill de bibliothèque (le cas échéant) charger ensuite. Si l'utilisateur ne sait pas encore quelle bibliothèque — c'est en soi une réponse de routage (voir le tableau Guides spécifiques aux bibliothèques et modules ci-dessus et laissez l'utilisateur choisir).
4. Dans quel langage prévoyez-vous d'écrire le programme ? C / C++, Rust, Go, Python, autre ?	La surface publique de DOCA est une ABI C. Les consommateurs non-C passent par FFI / liaisons de langage (`doca-programming-guide CAPABILITIES.md ## Capabilities and modes` et la skill par bibliothèque). Les exemples C sont la référence même quand le langage de l'utilisateur n'est pas C.	Choisit si les conseils de première app de l'agent sont build C direct ou FFI / liaisons contre l'ABI C. Ne change pas quel exemple l'agent pointe en premier.

La règle de l'agent : ne recommandez jamais un chemin d'installation spécifique, une balise de conteneur, ou un exemple sans d'abord avoir les réponses aux questions 1–3 (la question 4 est nécessaire pour le workflow de première app mais pas pour l'orientation elle-même). Proposer des commandes spécifiques avant cela est le mode d'échec le plus courant pour l'orientation DOCA.

Si l'utilisateur a déjà fourni une partie de l'information dans son premier message, marquez ces questions comme répondues et ne posez que les autres. Ne redemandez pas ce que l'utilisateur vous a déjà dit.

Table de routage du sujet à « où chercher d'abord »

Quand l'utilisateur pose une question, routez comme suit :

Intention de l'utilisateur	Premier endroit à chercher
« Comment installer DOCA ? »	Guide d'installation + page Téléchargements (Points d'accès à la documentation publique).
« Comment commencer avec DOCA — quelle est la toute première chose ? »	Guide de démarrage rapide pour développeurs si l'utilisateur a du matériel BlueField + hôte ; sinon `doca-setup ## no-install` Chemin 0 (conteneur NGC). Utilisez les quatre questions dans Découverte au premier contact pour choisir.
« Ai-je besoin d'un BlueField ? D'une SmartNIC ? Ou juste DOCA-Host ? »	Page de présentation (`doca-overview/index.html`) plus la section Profils d'installation DOCA du Guide d'installation. Le bundle ne choisit pas le matériel pour l'utilisateur — ces deux pages le font.
« Quel paquet me donne la bibliothèque X ? »	Section de matrice de paquet du Guide d'installation ; puis vérifiez sur le système de l'utilisateur avec `pkg-config --list-all`.
« Montrez-moi un exemple qui utilise la bibliothèque X. »	`/opt/mellanox/doca/samples/doca_<X>/` s'il est installé ; sinon le guide par bibliothèque sur `docs.nvidia.com/doca/sdk/` (chaque guide de bibliothèque documente les exemples fournis avec lui).
« Comment compiler un exemple DOCA ? »	Guide de bibliothèque + le propre `meson.build` de l'exemple dans `/opt/mellanox/doca/samples/...`.
« Quelle est l'API pour X ? »	Guide de bibliothèque ; confirmez en inspectant les en-têtes sous `$(pkg-config --variable=includedir doca-common)` (généralement `/opt/mellanox/doca/include/` sur DOCA 3.3+ ; `/opt/mellanox/doca/infrastructure/include/` sur installations legacy / profil fractionné).
« Pourquoi ma compilation échoue-t-elle avec `pkg-config` qui ne trouve pas `doca-...` ? »	Section « Layout of an installed DOCA package » ci-dessus (`PKG_CONFIG_PATH`), puis Guide d'installation.
« Quelle est la version la plus récente / qu'est-ce qui a changé ? »	Notes de version.
« Y a-t-il une DOCA plus récente — devrais-je mettre à jour / rétrograder / revenir en arrière ? »	`doca-upgrade` pour la discipline détecter → rapporter → DEMANDER → mise à niveau guidée (jamais de mise à niveau auto) ; Notes de version pour ce que la version cible contient.
« Le composant dont je dépends est-il en fin de vie / déprécié ? »	Notes de version (avis de cycle de vie / dépréciation), accessibles via la vérification de sensibilisation aux couchers de soleil du `doca-upgrade` ; n'affirmez pas la dépréciation de mémoire.
« Que signifie le numéro de version DOCA ? LTS est-il toujours supporté ? »	Politique de compatibilité (tableau Points d'accès à la documentation publique).
« Comment exécuter DOCA sur Kubernetes / provisionner un DPU ? »	Framework de plateforme DOCA sur GitHub.
« J'ai un comportement que je ne peux pas expliquer. »	Notes de version (problèmes connus) d'abord ; puis le Forum des développeurs DOCA. N'allez jamais au forum en premier.

Ce que cette skill couvre intentionnellement pas

Ce fichier est intentionnellement une cartographie, pas un tutoriel. Il ne contient pas :

Tutoriels de bibliothèque DOCA (ils se trouvent dans les guides par bibliothèque).
Référence API (se trouve dans les en-têtes et les guides par bibliothèque).
Plongées profondes dans les systèmes de compilation (se trouvent dans le Guide d'installation et les fichiers meson.build des exemples).
Optimisation des performances, configuration au niveau du pilote, interaction OFED (se trouve dans le Guide d'installation et les guides spécifiques aux bibliothèques).

Quand l'agent a besoin de ceux-ci, il doit récupérer le document public correspondant ou lire le fichier installé correspondant. Au fur et à mesure que des skills plus ciblées sont ajoutées, elles doivent apparaître dans SKILLS.md et renvoyer ici pour les recherches « où chercher ».

Skills connexes

Pour la préparation de l'env — vérification de l'installation, environnement de compilation (pkg-config, en-têtes, hugepages, devlink), débogage au niveau env-class, et le chemin Je n'ai pas encore d'installation avec le conteneur DOCA NGC public (nvcr.io/nvidia/doca/doca) comme fallback universel Phase-1 pour tout utilisateur sur macOS, Windows, ou Linux sans DOCA — chargez doca-setup. Cette skill s'arrête à « l'installation est saine et l'env est prêt ».

Pour les motifs de programmation DOCA généraux partagés par chaque bibliothèque — le motif de compilation canonique pkg-config doca-<library> (C/C++ direct ou non-C via FFI), le workflow universel dériver une première app personnalisée à partir d'un exemple fourni, le cycle de vie universel (cfg-create → init → start → use → stop → destroy), la taxonomie inter-bibliothèques DOCA_ERROR_*, et l'ordre de débogage du côté programme — chargez doca-programming-guide. Chaque skill de bibliothèque étend sa ## modify (dérivation de première app) avec des substitutions spécifiques à la bibliothèque.

Pour les mécanismes internes de DOCA Flow — configuration du port et du représenteur, création de pipe, spécifications de correspondance/action, validation du pipe avant la programmation du matériel, compteurs et traces Flow, compatibilité de version Flow, et débogage des défaillances DOCA_ERROR_* de l'API Flow — chargez doca-flow. Cette skill suppose que celle-ci est disponible pour le routage de documentation partagée et les recherches de disposition d'installation, doca-setup pour la préparation de l'environnement, et doca-programming-guide pour les motifs de programmation inter-bibliothèques sur lesquels elle s'appuie.