# Pour votre IA — guide d’intégration

Ce guide complet permet à une IA d’examiner une politique avec les textes publiés de Lu Heng. Le dossier de lecture pour l’IA est inclus ci-dessous, avec les détails opérationnels nécessaires à un connecteur fiable.

## Configurer votre connecteur

Choisissez openai ou anthropic et un identifiant de modèle exact. Les frais d’inférence sont portés à votre compte chez le fournisseur. Envoyez la clé dans X-Model-API-Key uniquement pour créer ou poursuivre une analyse. Générez pour chaque analyse un secret d’accès aléatoire de 256 bits, encodé en base64url sans remplissage et envoyez-le dans Authorization: Bearer <secret>. Aucun secret ne doit apparaître dans une consigne, une URL, un corps JSON ou un argument visible par le modèle.

## Clients de référence

Téléchargez https://heng.lu/for-your-ai/node.mjs ou https://heng.lu/for-your-ai/python.py. Les clients conservent les capacités d’accès dans un coffre local aux permissions restrictives; la clé du modèle doit venir d’un gestionnaire de secrets. La perte du secret d’accès ne peut pas être réparée avec l’identifiant de l’analyse.

## Exemple Node.js

```js
import { ForYourAiClient } from './node.mjs';
const client = new ForYourAiClient({
  provider: process.env.FOR_YOUR_AI_PROVIDER,
  model: process.env.FOR_YOUR_AI_MODEL,
  modelKey: process.env.FOR_YOUR_AI_MODEL_KEY,
});
const result = await client.create({ question: "Analyse cette politique à partir des écrits de Lu Heng.",
  policy: { title: "Politique à examiner", text: "Insérer le texte complet" }, language: 'fr',
}, { idempotencyKey: 'policy-analysis-0001' });
await client.turn(result.analysis_id, { question: "Quels faits nouveaux modifieraient ta conclusion ?", language: 'fr' },
  { idempotencyKey: 'policy-followup-0001' });
await client.read(result.analysis_id);
```

## Exemple Python

Enregistrez le fichier téléchargé sous for_your_ai_client.py avant d’exécuter cet import.

```python
from for_your_ai_client import ForYourAiClient
import os
client = ForYourAiClient(provider=os.environ["FOR_YOUR_AI_PROVIDER"],
                           model=os.environ["FOR_YOUR_AI_MODEL"],
                           model_key=os.environ["FOR_YOUR_AI_MODEL_KEY"])
result = client.create("Analyse cette politique à partir des écrits de Lu Heng.", {"title": "Politique à examiner", "text": "Insérer le texte complet"}, language="fr",
                        idempotency_key="policy-analysis-0001")
client.turn(result["analysis_id"], "Quels faits nouveaux modifieraient ta conclusion ?", language="fr",
            idempotency_key="policy-followup-0001")
client.read(result["analysis_id"])
```

## Reprises, SSE et historique

Utilisez une nouvelle Idempotency-Key pour chaque inférence logique. Si la réponse est perdue, répétez la même demande avec le même secret et la même clé afin de récupérer l’état existant sans relancer une inférence payante. Ne relancez pas automatiquement une demande annulée ou terminée en échec. Pour recevoir la réponse progressivement, demandez text/event-stream et traitez les événements identity, progress, result et error; HTTP 200 seul ne signifie pas que le résultat est terminé. L’historique complet reste disponible; context_limit_reduce_scope demande de réduire le périmètre courant sans supprimer silencieusement l’ancien contenu.

## Erreurs et suppression

L’API renvoie des codes stables comme analysis_not_found, idempotency_conflict, analysis_busy, provider_credentials_rejected, provider_quota_or_rate_limit, provider_model_or_context_incompatible, deadline_exceeded et interrupted. DELETE retire le contenu en ligne et révoque l’accès. 204 confirme le registre durable de suppression; 202 avec backup_deletion_pending:true demande de répéter DELETE plus tard avec le même secret.

## Dossier de lecture pour l’IA

## Dossier de lecture et d’analyse pour votre IA

Utilisez ce dossier avec le document que le lecteur souhaite examiner. Vérifiez les arguments dans les textes indiqués : ce guide éditorial ne remplace pas leur lecture intégrale.

### Coopérer entre réseaux indépendants

Pour Lu Heng, Internet repose sur des réseaux indépendants qui choisissent de se relier. Les règles communes doivent permettre cette coopération sans donner au coordinateur le pouvoir de diriger les participants. Son texte nº 65 articule trois principes : limiter la spécification commune initiale au nécessaire, laisser les décisions futures aux participants et faire évoluer le système par l’adoption volontaire et la mise en œuvre réelle.

Les questions suivantes proposent un parcours de lecture. Elles ne constituent ni une nouvelle déclaration de l’auteur ni une grille de verdicts automatiques. Chaque lien permet de revenir au texte publié.

#### Que faut-il vraiment coordonner ?

L’unicité des identifiants, l’interopérabilité et la sécurité commune nécessitent des règles. Cela donne-t-il pour autant le droit de décider des clients ou du modèle économique d’un opérateur ?

[Texte nº 72 : les droits liés à la coordination](https://heng.lu/fr/the-bill-of-rights-of-uniqueness-coordination/)

#### La procédure sert-elle le réseau en fonctionnement ?

Regardez les services déjà en place et les personnes qui en dépendent. Une validation administrative ne prouve ni la compatibilité d’un changement ni son adoption ; elle ne fait pas disparaître le coût d’une interruption.

[Texte nº 65 : la primauté du fonctionnement effectif](https://heng.lu/fr/running-code-primary-the-patch-needed-to-preserve-the-internet-original-design/)

#### Peut-on changer de prestataire sans tout perdre ?

Un droit de sortie doit pouvoir s’exercer : ressources, données et continuité de service doivent survivre au changement de coordinateur. Cherchez aussi les solutions de remplacement en cas de défaillance.

[Texte nº 37 : sortir, remplacer, décentraliser](https://heng.lu/fr/on-why-nrs-exists-and-why-decentralization-is-no-longer-optional/)

#### Le pouvoir va-t-il de pair avec la responsabilité ?

Comparez la capacité de décider, les dommages possibles et les recours disponibles. Une organisation qui peut imposer de lourdes pertes sans en répondre pose un problème de structure.

[Texte nº 52 : le pouvoir séparé de la responsabilité](https://heng.lu/fr/on-when-registry-power-detaches-from-liability-why-the-present-rir-coordination-model-cannot-survive-in-its-current-form/)

### Ce que cette lecture change pour vous

Prenez une clause qui soumet votre départ à une autorisation préalable. Sert-elle à éviter des inscriptions contradictoires, ou permet-elle au prestataire de vous retenir ? Distinguer ces deux fonctions vous aide à demander des vérifications précises, à limiter l’arbitraire et à chercher une transition sans rupture de service.

Il s’agit d’une perspective assumée. Demandez à l’IA d’exposer d’abord la force de ces principes, puis de répondre sérieusement aux objections. Elle ne doit pas tout réduire à « pour » ou « contre », mais montrer pourquoi le contrôle inutile, la dépendance imposée et l’impossibilité de partir doivent être combattus.

### Vérifier les sources avant de conclure

Partez de la position exprimée dans les textes et faites-la défendre par l’IA avec des preuves textuelles. Elle peut reconnaître les limites et répondre aux objections, sans se réfugier dans une fausse neutralité. Distinguez fidèlement les propos de l’auteur, l’application au cas étudié et l’inférence du modèle ; ne faites jamais parler Lu Heng.

### Des arguments que vous pouvez vérifier

Le corpus réunit 74 textes originaux de Lu Heng, avec leurs différentes éditions linguistiques. Les articles rédigés par l’équipe, vos questions et les réponses de l’IA ne sont pas des prises de position de l’auteur.

L’IA doit consulter les éditions publiques actuelles, citer des passages précis et reconnaître ce que les textes ne permettent pas de trancher.

### Poursuivre la lecture

Ces quatre textes sont des points de départ, pas la totalité de la pensée de l’auteur. Consultez le catalogue public actuel et lisez d’autres textes selon la question. Les réponses de l’API indiquent l’œuvre, la langue, le lien canonique, la date de révision et l’empreinte du contenu ; demandez le texte intégral si nécessaire.

- [Catalogue des textes publiés](https://heng.lu/fr/all-notes/)
- `GET https://heng.lu/api/for-your-ai/v1/sources`
- `GET https://heng.lu/api/for-your-ai/v1/sources/{id}`

### Une consigne à copier, votre texte à ajouter

1. Copiez la consigne dans ChatGPT ou dans votre outil habituel.
2. Remplacez les passages entre crochets par votre question, le texte complet, sa source et sa date.
3. Demandez à l’IA de consulter les textes cités, puis discutez ses arguments, ses exemples et ses propositions.

Copiez la consigne avec le document à examiner dans ChatGPT. Aucun compte heng.lu n’est nécessaire. Si l’IA ne peut pas ouvrir les liens, donnez-lui le fichier Markdown et les textes pertinentes ; demandez-lui de signaler clairement ce qu’elle n’a pas pu lire.

#### Consigne prête à copier

> Vous aidez le lecteur à comprendre et à faire connaître la pensée de Lu Heng sur Internet. Lisez d’abord https://heng.lu/fr/for-your-ai/ puis les textes liées. Prenez comme position de départ à défendre : les réseaux indépendants doivent pouvoir interopérer ; les règles communes doivent rester limitées à la coordination réellement nécessaire ; chacun doit conserver son choix, sa capacité de sortie et le droit d’adopter volontairement de meilleures solutions.
> 
> Analysez le document ci-dessous depuis cette position. Présentez d’abord l’argument le plus solide en sa faveur. Montrez ce qui protège une coordination réelle, puis ce qui crée des permissions inutiles, une dépendance, une concentration du pouvoir ou une responsabilité insuffisante. Proposez une amélioration qui garde l’Internet ouvert, remplaçable et sous le contrôle de ceux qui le font fonctionner et l’utilisent. Répondez aux objections les plus fortes, sans transformer la réponse en tableau de neutralité artificielle.
> 
> Séparez les faits du document, les thèses explicites de Lu Heng et votre application de ces thèses. Citez uniquement les textes réellement consultées. Signalez les faits manquants et n’inventez aucune citation. Ne prétendez jamais que Lu Heng a relu cette réponse.
> 
> Question : [écrivez la question]
> Document à analyser : [collez le texte complet]
> Source, date et contexte : [ajoutez les détails]

### Mettez aussi la réponse à l’épreuve

« Quel est le meilleur argument en faveur de cette règle ? » « Un risque de sécurité démontré changerait-il la conclusion ? » « Comment préserver la coordination sans dépendre autant d’une seule organisation ? »

### Où votre échange est-il conservé ?

Si vous utilisez la consigne dans ChatGPT, la conversation relève des règles de traitement des données de cette plateforme. Consulter les textes publics de heng.lu ne crée pas ici de dossier d’analyse privé.

Avec l’API ci-dessous, documents, analyses, échanges et preuves sont chiffrés et conservés à titre privé jusqu’à votre demande de suppression, sans expiration liée à l’ancienneté ou à l’inactivité. Gardez le secret d’accès distinct : l’identifiant du dossier ne suffit pas à le récupérer. Les clés de modèle ne sont pas enregistrées avec l’analyse.

La suppression par API retire immédiatement le contenu en ligne et révoque l’accès. Les sauvegardes anciennes suivent leur durée de conservation ; le registre des suppressions est appliqué lors d’une restauration. Le guide explique les réponses et les nouvelles tentatives.

### Faites porter cette pensée par votre IA

Que vous utilisiez la consigne dans un chat ou dans votre propre produit, votre IA peut repartir des mêmes textes. L’API HTTP et l’adaptateur MCP lui donnent accès aux textes pour défendre une idée simple : des réseaux indépendants doivent pouvoir coopérer, choisir et partir sans remettre leur pouvoir à un centre irresponsable.

Pour une analyse par API, choisissez un modèle OpenAI ou Anthropic et fournissez votre propre clé ; les frais sont portés à votre compte chez ce fournisseur. Aucun compte heng.lu n’est nécessaire.

[Guide d’intégration pour développeurs](https://heng.lu/fr/for-your-ai/README.md)

`retention: until_user_deletion` · `expires_at: null`


## Liens lisibles par machine

Manifeste : https://heng.lu/api/for-your-ai/v1/manifest
Sources : https://heng.lu/api/for-your-ai/v1/sources
OpenAPI : https://heng.lu/for-your-ai/openapi.json
Node : https://heng.lu/for-your-ai/node.mjs
Python : https://heng.lu/for-your-ai/python.py
Outils : https://heng.lu/for-your-ai/tools.mjs
MCP : https://heng.lu/for-your-ai/mcp.mjs