Phase 14: Agent Engineering

Les agents délégués travaillent avec des contrats d'isolement et de fusion

Les agents parallèles ne permettent d'économiser du temps sur le mur que lorsque le travail est indépendant.

Type: Learn + Build

Languages: Python (stdlib)

Prerequisites: Phase 14 lessons 39 and 44

Time: ~70 minutes

Objectifs d'apprentissage

  • Décider si la délégation est justifiée par une véritable indépendance.
  • Donnez à chaque travailleur la propriété exclusive des dossiers et une preuve explicite.
  • Des ondes d'exécution de calcul provenant de dépendances.
  • Conçuez un contrat de fusion pour combiner le travail des agents en toute sécurité.

Le test de parallélisme

Ne déléguer pas parce qu'il y a plus d'agents disponibles.

  • deux enquêtes peuvent répondre de manière indépendante à des inconnues différentes;
  • deux mises en œuvre possèdent des dossiers et des contrats disjoints;
  • un examinateur peut inspecter un artefact fini sans le modifier;
  • un contrôle extérieur lent peut être effectué pendant que les travaux locaux se poursuivent.

Gardez le travail en série lorsque les agents ont besoin des mêmes fichiers, de la même décision non résolue ou du même environnement changeant.

Une unité de travail est un contrat

Chaque unité déléguée a besoin de:

FieldMeaning
GoalOne observable result
OwnerOne accountable worker
PathsExclusive write ownership
DependenciesCompleted units required before starting
ProofExact evidence returned to the integrator
HandoffFiles changed, decisions made, remaining risk

Manifiez le backend n'est pas une unité de travail. Implémenter le double contrôle app/accounts.pyet prouver avec le test de compte ciblé est.

L'isolement est constitué de trois couches

  1. Filesystem isolation:Les arbres de travail ou les boîtes à sable séparés empêchent les modifications partagées accidentelles.
  2. Ownership isolation:Les contrats empêchent deux travailleurs de modifier intentionnellement le même chemin.
  3. State isolation:Les journaux et les sorties séparés empêchent un travailleur de surécrire les preuves d'un autre travailleur.

L'isolement du système de fichiers ne résout pas la propriété. Deux arbres de travail propres peuvent toujours produire des conceptions contradictoires.

flowchart TD
  P[Approved plan] --> A[API work unit]
  P --> D[Docs work unit]
  A --> H1[Proof and handoff]
  D --> H2[Proof and handoff]
  H1 --> R[Read-only integration review]
  H2 --> R
  R --> G[Full verification gate]

L'intégrateur ne reconstruit pas l'œuvre

L'intégrateur doit:

  1. confirmer que chaque remise correspond à sa portée assignée;
  2. lire la preuve, et pas seulement le résumé du travailleur;
  3. combiner les changements d'ordre de dépendance;
  4. faire fonctionner la porte de l'unité transversale complète;
  5. rejeter l'expansion cachée du champ d'application;
  6. enregistrer les conflits comme de nouvelles décisions, pas des éditions silencieuses.

Si l'intégration nécessite la réécriture de la plupart des résultats d'un travailleur, la décomposition initiale était erronée.

Les rôles de l'homme et de l'agent

La délégation ne supprime pas le jugement humain. L'homme possède toujours des choix qui modifient le comportement public, le risque, l'autorité ou les coûts irréversibles.

Il s'agit d'une autonomie calibrée: le système accorde la liberté lorsque les preuves et le retour sont solides, et nécessite un point de contrôle lorsque les conséquences sont élevées.

Faites-le

Le laboratoire vérifie le chevauchement des chemins, valide les dépendances, calcule les ondes d'exécution sûres et écrit outputs/delegation-plan.json- Je suis désolé .

Je vais courir .

bashpython3 code/main.py
python3 -m unittest discover code/tests -v

Changez l' unité de docs à la propriété app/Le plan devrait être bloqué parce que ce chemin parent se chevauchera sur l'unité API.

Exercices

  1. Décomposer un changement réel en deux unités de travail indépendantes et un intégrateur.
  2. Trouvez une fraction parallèle proposée qui ne semble qu'indépendante.
  3. Ajoutez un chercheur qui ne peut lire que le contenu de son produit est un tableau de faits.
  4. Ajouter une passerelle de fusion qui vérifie le jeu de fichiers modifiés final contre tous les contrats unitaires.
  5. Définir une règle d'annulation pour un travailleur dont la dépendance devient invalide.

Pour en savoir plus

Ce que vous gardez

Je le garde .outputs/delegation-plan.jsonIl indique pourquoi la fraction est sûre, qui possède chaque chemin et quelle preuve l'intégration doit recevoir.

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.