---
title: "Assistants IA et agents"
description: "Kontainers est pensé pour être piloté par vos assistants IA : documentation lisible par les LLM, RBAC qui permet le diagnostic autonome, accès dédiés et révocables pour vos agents."
source_url:
  html: https://docs.blackswift.cloud/comprendre/assistants-ia/
  md: https://docs.blackswift.cloud/comprendre/assistants-ia.md
---

# Assistants IA et agents

> Kontainers est pensé pour être piloté par vos assistants IA : documentation lisible par les LLM, RBAC qui permet le diagnostic autonome, accès dédiés et révocables pour vos agents.

Que vous travailliez avec Claude, Cursor, Copilot ou un agent qui pilote
`kubectl`, votre assistant IA est un utilisateur de la plateforme comme un
autre. Nous l'outillons comme tel — voici tout ce qui est en place pour qu'il
soit efficace chez nous, et pourquoi ça change votre quotidien.

## Donnez cette documentation à votre IA

Un assistant généraliste connaît Kubernetes, pas Kontainers : il vous proposera
spontanément des manifests *presque* justes (une limite mémoire différente de la
request, un Service LoadBalancer par réflexe…). La parade tient en une URL —
cette documentation est publiée au format
[llms.txt](https://llmstxt.org/), le standard de documentation lisible par les
LLM :

| URL | Contenu | Usage |
| --- | --- | --- |
| [`/llms.txt`](https://docs.blackswift.cloud/llms.txt) | L'index + les spécificités plateforme essentielles | Point d'entrée, découverte automatique par les outils |
| [`/llms-full.txt`](https://docs.blackswift.cloud/llms-full.txt) | Les 40+ pages en markdown brut, Référence en tête | À charger dans le contexte de votre assistant |
| [`/llms-small.txt`](https://docs.blackswift.cloud/llms-small.txt) | Version compacte | Petites fenêtres de contexte |

En pratique :

```text
Lis https://docs.blackswift.cloud/llms-full.txt puis génère le manifest
de déploiement de mon application sur mon namespace Kontainers.
```

Un assistant qui a lu ces pages produit spontanément des manifests conformes :
`requests = limits` en mémoire, Ingress plutôt que LoadBalancer, classes de
stockage correctes, CNPG pour PostgreSQL.

### Chaque page, en markdown

Inutile de charger toute la documentation pour une question précise : chaque
page existe aussi en markdown, à la même adresse suivie de `.md`.

| Page | Version markdown |
| --- | --- |
| [`/reference/quotas-et-limites/`](https://docs.blackswift.cloud/reference/quotas-et-limites/) | [`/reference/quotas-et-limites.md`](https://docs.blackswift.cloud/reference/quotas-et-limites.md) |
| [`/`](https://docs.blackswift.cloud/) (accueil) | [`/index.md`](https://docs.blackswift.cloud/index.md) |

Votre assistant n'a d'ailleurs souvent rien à faire pour en profiter :

- les agents qui demandent du markdown en priorité (en-tête
  `Accept: text/markdown`, comme Claude Code, Cursor, Copilot ou OpenCode)
  le reçoivent directement sur l'URL habituelle de la page ;
- chaque page HTML signale sa version markdown dans son en-tête
  (`<link rel="alternate" type="text/markdown">`), que d'autres agents
  savent suivre ;
- dans ces versions markdown, les liens vers les autres pages pointent
  eux aussi vers leur version `.md` : l'agent navigue d'une page à l'autre
  sans repasser par le HTML.

```text
Lis https://docs.blackswift.cloud/reference/mutations-et-politiques.md
avant de corriger mon Deployment.
```

## Un RBAC qui permet le diagnostic autonome

Le talon d'Achille des agents IA sur un cluster managé : les lectures
interdites. Un agent qui enchaîne les `Forbidden` sur `events` ou
`resourcequotas` abandonne — ou pire, invente. Sur Kontainers, [le rôle
client](https://docs.blackswift.cloud/reference/permissions-et-rbac.md) a été élargi précisément pour que la
boucle de diagnostic se fasse **sans intervention humaine** :

| Symptôme | Ce que votre agent peut lire |
| --- | --- |
| Pod qui ne se crée pas | `events`, conditions du ReplicaSet, `resourcequotas` (avec le message de rejet exact) |
| OOMKilled | `describe pod`, `kubectl top pods`, `limitranges` |
| Certificat bloqué | Toute la chaîne ACME : `certificates`, `certificaterequests`, `orders`, `challenges` |
| Connexion refusée | Les `networkpolicies` réellement appliquées, `endpointslices` |

Et les [messages d'erreur de la plateforme sont documentés
verbatim](https://docs.blackswift.cloud/depanner/pod-en-erreur.md) : quand votre agent rencontre un rejet
Kyverno ou PodSecurity, le texte exact de l'erreur est cherchable dans cette
doc — donc dans son `llms-full.txt`.

## Un accès dédié, borné et révocable pour vos agents

Ne prêtez pas votre kubeconfig personnel à un agent. Créez-lui un
[**kubeconfig permanent**](https://docs.blackswift.cloud/operer/ci-cd-avec-le-serviceaccount.md) :

- périmètre limité à **un namespace** — l'agent ne voit rien d'autre ;
- n'expire pas en pleine session de travail ;
- révocable en une commande (`kubectl delete blackswiftpermanentkubeconfig`) ;
- traçable : la colonne `LAST USED` vous dit s'il sert encore.

Et si votre agent s'emballe, [les garde-fous de la
plateforme](https://docs.blackswift.cloud/reference/mutations-et-politiques.md) jouent pour lui comme pour
vous : quotas plafonnés, requests injectées, pods privilégiés rejetés,
namespaces des autres clients inaccessibles [par
design](https://docs.blackswift.cloud/comprendre/isolation-reseau.md). Un agent ne peut ni faire déborder
votre facture au-delà des quotas, ni toucher au reste du cluster.

## Des exemples que votre IA peut recopier les yeux fermés

Chaque exemple de cette documentation ([WordPress](https://docs.blackswift.cloud/exemples/wordpress.md),
[stack complète](https://docs.blackswift.cloud/exemples/stack-web-complete.md), [n8n](https://docs.blackswift.cloud/exemples/n8n.md)…) a été
**réellement déployé et testé sur la plateforme** avant publication. Un
assistant qui s'en inspire part d'une base qui fonctionne — pas d'un extrait de
blog de 2021.

## Le mot de prudence

Un assistant outillé reste un assistant : relisez ce qu'il applique sur un
namespace de production, et préférez lui donner un namespace de dev pour
itérer ([les environnements sont faits pour ça](https://docs.blackswift.cloud/operer/organiser-vos-environnements.md)).
La [sauvegarde quotidienne](https://docs.blackswift.cloud/operer/sauvegardes-et-restauration.md) est votre
filet — pour vous comme pour lui.