Phase 13: Tools & Protocols

Capstone: Écosystème d'outils sans État

Type: Build

Languages: Python (stdlib, in-process simulation)

Prerequisites: Phase 13 · 01 through 22, using MCP revision 2026-07-28

Time: ~120 minutes

Objectifs d'apprentissage

• Composer des appels à l'outil, des résultats en forme de tâche, des travaux délégués, des ressources UI, des politiques d'autorisation et des enregistrements de suivi en un seul flux.
• Portez la version du protocole, l'identité du client et les capacités sur chaque demande de MCP au lieu de compter sur une session de connexion.
• Découvrez un serveur avant utilisation et effectuez des travaux longs à travers l'extension officielle Tasks.
• Distinguer une simulation en forme de protocole d'une mise en œuvre MCP, A2A, OAuth ou OpenTelemetry.
• Mettez chaque limite simulée sur la composante de production qui doit la remplacer.
• Je le garde .AGENTS.md, une compétence d'agent, des adaptateurs de temps d'exécution, des outils et des politiques de sécurité dans leurs rôles corrects.
• Expliquez quelles revendications peuvent être vérifiées à partir de la production locale et quelles nécessitent des tests d'intégration en direct.

Le problème

Conception d'un système de recherche et de rapport. Un utilisateur demande des documents sur les protocoles d'agent. Le système recherche un catalogue papier, délègue la résumé, génère un rapport, renvoie une ressource UI et enregistre le chemin à travers le système.

Cette phrase cache plusieurs contrats indépendants:

• un schéma d'outil axé sur le modèle;
• une enveloppe de demande sans statut et un contrat de découverte du serveur;
• une décision de passerelle pour l'acteur, la portée et l'identité de l'outil;
• un contrat d'exploitation à long terme;
• un protocole de délégation;
• un pont entre l'hôte et l'application;
• la propagation et l'exportation de traces;
• une procédure opérationnelle réutilisable.

code/main.pyIl ne permet pas d'ouvrir un transport, de contacter arXiv, d'effectuer OAuth, d'appeler un serveur A2A, de rendre une application MCP ou d'exporter la télémétrie. Cela facilite l'inspection du flux de contrôle sans présenter une simulation comme un service conforme.

Le concept

Architcture cible

flowchart LR
  U[User] --> C[Agent client]
  C --> G[Authorization gateway]
  G --> M[Research MCP server]
  M --> T[Search and report tools]
  M --> R[Resources and prompts]
  M --> Q[Task store]
  M --> A[A2A client]
  A --> W[Writer agent]
  M --> UI[MCP App resource]
  C --> O[Telemetry exporter]
  G --> O
  M --> O
  A --> O

L'architecture est une composition conceptuelle de modèles de protocoles publics.

Trace de la cible

flowchart TD
  I[agent.invoke_agent] --> SD[server/discover]
  I --> L1[llm.chat]
  I --> S[tools/call: arxiv_search]
  I --> D[A2A SendMessage]
  D --> X[Opaque writer-agent execution]
  I --> G[tools/call: generate_report]
  G --> K[tasks/get polling]
  K --> V[completed Task with final result]
  V --> UI[ui:// report resource]
  I --> L2[llm.chat final synthesis]

Dans une mise en œuvre réelle, chaque saut propage un contexte de traces. Les noms et attributs de la bande doivent suivre les conventions sémantiques OpenTelemetry prises en charge par la version d'instrumentation choisie.

Surfaces de protocole courantes

Utilisez les noms de méthode définis par le protocole actuel, et non les noms retenus dans un projet plus ancien:

Les noms de protocoles ne sont que la première couche. Les tests de production doivent exécuter la sérialisation, les échecs d'authentification, l'annulation, les délais, les retries et la compatibilité des versions sur le fil réel.

Le PCM apatrid change la limite d'intégration

Révision 2026-07-28supprime les sessions de protocole et lesinitialize- Je suis là .notifications/initializedIl enlève aussi.Mcp-Session-IdChaque demande porte ces espaces de noms ._metachamps:

jsonCopy{
  "io.modelcontextprotocol/protocolVersion": "2026-07-28",
  "io.modelcontextprotocol/clientCapabilities": {
    "extensions": {
      "io.modelcontextprotocol/tasks": {}
    }
  },
  "io.modelcontextprotocol/clientInfo": {
    "name": "capstone-client",
    "version": "1.0.0"
  }
}

Le serveur doit mettre en œuvre server/discover. Utilisation des résultats ordinaires resultType: "complete"; utilise une manette de tâche resultType: "task". Chaque résultat doit identifier le serveur dans _meta.io.modelcontextprotocol/serverInfo- Je suis désolé .

L' extension de tâche atasks/get- Je suis là .tasks/update, et tasks/cancelUn outil peut revenir en premier .resultType: "task"- le président .tasks/getelle-même revient resultType: "complete", et le complet TaskLe résultat final est le résultat final.tasks/resultet tasks/listLes méthodes ne font pas partie de l'extension actuelle.io.modelcontextprotocol/tasksDans le même cas, le serveur retourne -32021avec requiredCapabilitiesen forme d'objet manquant de capacité de client, y compris extensions.io.modelcontextprotocol/tasks- Je suis désolé .

Position de sécurité

Le déploiement prévu utilise la défense en profondeur:

• Autorisation d'autorisation d'autorisation avec PKCE lorsque le type de client l'exige;
• la liaison des ressources et du public pour les jetons d'accès émis;
• la passerelle RBAC qui vérifie l'outil et la portée demandés;
• les informations d'identification en amont détenues en dehors du contexte visible du modèle;
• un manifeste de description des outils fixé ou examiné;
• une révision de la règle de deux pour les entrées non fiables, les données sensibles et les actions qui en découlent;
• une boîte à sable d'exécution dont le système de fichiers, le processus, le réseau, les autorisations et les limites de ressources sont appliquées en dehors de la compétence.

La démo implémentera uniquement des jetons statiques, des contrôles de portée et des hashs de description.

Les compétences sont des procédures, pas des transports

Un agent de compétences peut dire à l'exécution du flux de travail de recherche, quels outils contracter à attendre, quelles preuves enregistrer, et quand arrêter. Il ne peut pas faire un serveur MCP existent, établir la compatibilité A2A, accorder des champs de travail, ou créer une boîte à sable.

flowchart TD
  RI[Repository instructions] --> H[Host runtime]
  SK[Agent Skill procedure] --> H
  H --> P[Invocation and permission policy]
  P --> MCP[MCP client adapter]
  P --> A2A[A2A client adapter]
  P --> EX[Sandboxed executor]

Envoyez le répertoire complet des compétences lorsque la procédure fait référence aux fichiers de compagnon. L'artefact plat dans cette ancienne pierre angulaire est un plan de cours, pas une preuve qu'un hôte conserve un paquet portable. Les leçons 24 à 27 construisent et testent le cycle de vie complet du paquet.

Les métadonnées des objets de cours sont un adaptateur local

Le catalogue et l'installateur du cours reconnaissent les fichiers plats nommés skill-*.mdLeur analyseur de frontmatter minimal ne lit que les clés de premier niveau. Cette leçon maintient donc les champs d'identité portables et les champs de catalogue de cours au même niveau:

yamlCopy---
name: ecosystem-blueprint
description: Produce a full Phase 13 ecosystem architecture for a product need.
version: "1.0.0"
phase: "13"
lesson: "23"
tags: [mcp, capstone, ecosystem, architecture, a2a, otel]
---

nameet descriptionsont les champs d'identité portables. version- Je suis là .phase- Je suis là .lesson, et tagsLes cours de l'analyseur nécessitent des extensions de catalogue spécifiques à la formation.tagscomme une liste en ligne donc --tag capstoneJe peux le faire.

Une compétence de répertoire portable peut utiliser l' option metadatacarte pour les données d'extension à valeur de chaîne.metadataSi ce fichier plat n'est pas disponible, il est possible de le remplacer par un schéma de catalogue de ce référentiel.versionou tagsci-dessous metadataLe parseur minimal saute ces touches en tirage, le catalogue enregistre une version vide et le filtrage des balises ne peut pas trouver l'artefact.

Simulation par rapport à la production

Cette table est la limite de transmission.

Carte de la phase 13

Faites-le

Remplissez le harnais en cours de traitement:

bashCopycd phases/13-tools-and-protocols/23-capstone-tool-ecosystem
python3 code/main.py

Il faut examiner cinq choses:

1. server/discoverannonce révision 2026-07-28et l'extension des tâches.
2. Alice peut lire et générer un rapport, tandis que l'appel écrit de Bob est refusé.
3. Chaque intervalle local dans une course d'orchestre partage un identifiant de trace et enregistre les identifiants de parent span.
4. Le rapport commence par une tâche. tasks/getrenvoie une tâche accomplie dont le résultat final contient du texte et une ui://de référence.
5. L'écrivain délégué reste opaque parce que l'orchestre enregistre seulement la portée limite.
6. Aucune sortie ne prévoit une connexion réseau, un échange d'AOuth, une exportation de collecteur, un rendu du navigateur ou une exécution de sandbox.

Le script est exécuté deux fois, ce qui produit deux traces racinaires.

Utilisez-le

Promouvoir une couche à la fois:

1. Remplacezserver_discover()et la liste d' outils statiques avec réel server/discoveret tools/listEnvoyez la version, l'identité et les capacités dans chaque demande.
2. Remplacez les jetons statiques par un serveur d'autorisation et une validation de ressource protégée.
3. La mise en œuvre de laio.modelcontextprotocol/tasksextension et test tasks/get- Je suis là .tasks/update- Je suis là .tasks/cancel, une pause, un TTL et un redémarrage de la récupération.tasks/resultou tasks/list- Je suis désolé .
4. Remplacez le bloc de délégation par un client A2A qui résout une carte d'agent et envoie un message.
5. Construisez l' App avec le SDK officiel et appelez les outils serveur via app.callServerTool- Je suis désolé .
6. Exporter des échantillons à un collecteur d'essai et affirmer la parentalité au destinataire.
7. Exécutez l'outil et l'exécution du script à l'intérieur du contrat de la boîte à sable de la leçon 26.
8. Emballez la procédure en tant que paquet complet d'annuaires et passez la passerelle de sortie de la leçon 27.

Chaque promotion a besoin d'un test d'intégration qui franchit la nouvelle frontière.

La faire partir

Cette leçon produit outputs/skill-ecosystem-blueprint.mdIl demande une architecture d'une page couvrant les primitifs, la sécurité, la délégation, la télémétrie, l'emballage et les risques opérationnels les plus difficiles.

Parce qu'il ne s'agit pas d'un paquet de répertoires, il ne peut pas contenir de références, de scripts, d'actifs ou de fixations d'évaluation.

Exercices

1. On court .code/main.py- Facts séparés prouvés par la production des revendications de production qui ont encore besoin de preuves d'intégration.
2. Ajoutez un second backend statique et définissez la règle de collision pour deux outils portant le même nom.tools/listIl appelle.
3. Remplacez le texte de l'écrivain par un serveur de test A2A. Enregistrez la carte de l'agent, la demande de message, le chemin de temps d'arrêt et l'artefact retourné.
4. Ajouter un stock de tâches qui survit à une redémarrage du processus. Prouver qu'un client peut reprendre avec tasks/get, le respect .pollIntervalMs, et lire le résultat final de la tâche accomplie sans tasks/result- Je suis désolé .
5. Construisez une application MCP minimale et vérifiez app.callServerTooldans un navigateur avec un CSP restrictif et des autorisations explicites.
6. Exporter les délais simulés à travers un SDK OTel vers un collecteur local. Afficher le reçu, les identifiants de traces, la parentalité et l'état d'erreur.
7. ÉcrivezAGENTS.mdpour les règles de maintenance de l'ensemble du référentiel et un ensemble de compétences distinct pour la procédure de recherche réutilisable.

Les termes clés

Pour en savoir plus

• MCP specification 2026-07-28pour les demandes, la découverte, les outils, l'autorisation et le comportement de transport.
• MCP 2026-07-28 key changespour la suppression de session, les métadonnées par demande, le MRTR, les extensions et les dépréciations.
• MCP Tasks extensionpour tasks/get- Je suis là .tasks/update- Je suis là .tasks/cancel, et les résultats finaux des tâches finales.
• MCP Apps SDKpour Appet app.callServerTool- Je suis désolé .
• A2A protocolpour les cartes d'agent, la livraison de messages, les tâches, les objets et les liaisons de transport.
• OpenTelemetry GenAI semantic conventionspour les conventions sur les traces et les attributs.
• Agent Skills specificationpour le contrat de colis portable utilisé par la couche procédurale.

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.