Compatibilité du Kit de développement logiciel (SDK) et de l’interface

Remarque

SDK Copilot est actuellement en préversion publique. Les fonctionnalités et la disponibilité sont susceptibles de changer.

          Kit de développement logiciel (SDK) GitHub Copilot communique avec CLI GitHub Copilot via le protocole JSON-RPC. Les fonctionnalités doivent être explicitement exposées via ce protocole pour être disponibles dans le Kit de développement logiciel (SDK). De nombreuses fonctionnalités cli interactives sont spécifiques au terminal et non disponibles par programme.

Comparaison des fonctionnalités

Disponible dans le Kit de développement logiciel (SDK)

Fonctionnalité	Méthode du Kit de développement logiciel (SDK	Remarques
Gestion de session
Créer une session	`createSession()`	Prise en charge complète de la configuration
Reprendre la session	`resumeSession()`	Avec des espaces de travail de session illimités
Déconnecter la session	`disconnect()`	Libérer des ressources en mémoire
Détruire la session	`destroy()`	Utilisation de `disconnect()` à la place
Supprimer une session	`deleteSession()`	Supprimer du stockage
Répertorier les sessions	`listSessions()`	Toutes les sessions stockées
Obtenir la dernière session	`getLastSessionId()`	Pour un CV rapide
Obtenir une session de premier plan	`getForegroundSessionId()`	Coordination multi-sessions
Définir une session de premier plan	`setForegroundSessionId()`	Coordination multi-sessions
Messages
Envoyer un message	`send()`	Avec des pièces jointes
Envoyer et attendre	`sendAndWait()`	Bloque jusqu'à ce que ce soit terminé
Direction (mode immédiat)	`send({ mode: "immediate" })`	Injecter au milieu du processus sans interrompre
Mise en file d’attente (mode d’enfilement)	`send({ mode: "enqueue" })`	Mémoire tampon pour le traitement séquentiel (par défaut)
Pièces jointes	`send({ attachments: [{ type: "file", path }] })`	Images codées automatiquement et redimensionnées
Pièces jointes du répertoire	`send({ attachments: [{ type: "directory", path }] })`	Attacher le contexte de répertoire
Obtenir l’historique	`getMessages()`	Tous les événements de session
Abandon	`abort()`	Annuler la requête en cours
Outils
Inscrire des outils personnalisés	`registerTools()`	Prise en charge complète du schéma JSON
Contrôle d’autorisation de l’outil

          `onPreToolUse` crochet | Autoriser/refuser/demander |

Non disponible dans le Kit de développement logiciel (CLI uniquement)

Fonctionnalité	Commande/option CLI	Reason
Exportation de session
Exporter vers le fichier

          `--share`, `/share` | Non dans le protocole |

Solutions de contournement

Exportation de session

L’option --share n’est pas disponible via le Kit de développement logiciel (SDK). Pour contourner ce problème :

Collectez manuellement les événements : Abonnez-vous aux événements de session et générez votre propre exportation :

TypeScript

const events: SessionEvent[] = [];
session.on((event) => events.push(event));
// ... after conversation ...
const messages = await session.getMessages();
// Format as markdown yourself

const events: SessionEvent[] = [];
session.on((event) => events.push(event));
// ... after conversation ...
const messages = await session.getMessages();
// Format as markdown yourself

Utilisez l’interface CLI directement pour les exportations ponctuelles.

Contrôle d’autorisation

Le Kit de développement logiciel (SDK) utilise un modèle d'autorisation qui refuse par défaut. Toutes les demandes d’autorisation (écritures de fichiers, commandes d’interpréteur de commandes, extractions d’URL et autres) sont refusées, sauf si votre application fournit un onPermissionRequest gestionnaire.

Au lieu de --allow-all-paths ou --yolo, utilisez le gestionnaire d’autorisations :

TypeScript

const session = await client.createSession({
  onPermissionRequest: approveAll,
});

const session = await client.createSession({
  onPermissionRequest: approveAll,
});

Suivi de l’utilisation des jetons

Au lieu de/usage, abonnez-vous aux événements d’utilisation

TypeScript

session.on("assistant.usage", (event) => {
  console.log("Tokens used:", {
    input: event.data.inputTokens,
    output: event.data.outputTokens,
  });
});

session.on("assistant.usage", (event) => {
  console.log("Tokens used:", {
    input: event.data.inputTokens,
    output: event.data.outputTokens,
  });
});

Compactage de contexte

Au lieu de /compact, configurez le compactage automatique ou déclenchez-le manuellement :

TypeScript

// Automatic compaction via config
const session = await client.createSession({
  infiniteSessions: {
    enabled: true,
    backgroundCompactionThreshold: 0.80,  // Start background compaction at 80% context utilization
    bufferExhaustionThreshold: 0.95,      // Block and compact at 95% context utilization
  },
});

// Manual compaction (experimental)
const result = await session.rpc.compaction.compact();
console.log(`Removed ${result.tokensRemoved} tokens, ${result.messagesRemoved} messages`);

// Automatic compaction via config
const session = await client.createSession({
  infiniteSessions: {
    enabled: true,
    backgroundCompactionThreshold: 0.80,  // Start background compaction at 80% context utilization
    bufferExhaustionThreshold: 0.95,      // Block and compact at 95% context utilization
  },
});

// Manual compaction (experimental)
const result = await session.rpc.compaction.compact();
console.log(`Removed ${result.tokensRemoved} tokens, ${result.messagesRemoved} messages`);

Remarque

Les seuils sont des ratios d’utilisation du contexte (0,0-1,0), et non des nombres de jetons absolus.

Gestion du plan

Lire et écrire des plans de session programmatiquement.

TypeScript

// Read the current plan
const plan = await session.rpc.plan.read();
if (plan.exists) {
  console.log(plan.content);
}

// Update the plan
await session.rpc.plan.update({ content: "# My Plan\n- Step 1\n- Step 2" });

// Delete the plan
await session.rpc.plan.delete();

// Read the current plan
const plan = await session.rpc.plan.read();
if (plan.exists) {
  console.log(plan.content);
}

// Update the plan
await session.rpc.plan.update({ content: "# My Plan\n- Step 1\n- Step 2" });

// Delete the plan
await session.rpc.plan.delete();

Direction des messages

Injecter un message dans le tour actuel du LLM sans interrompre :

TypeScript

// Steer the agent mid-turn
await session.send({ prompt: "Focus on error handling first", mode: "immediate" });

// Default: enqueue for next turn
await session.send({ prompt: "Next, add tests" });

// Steer the agent mid-turn
await session.send({ prompt: "Focus on error handling first", mode: "immediate" });

// Default: enqueue for next turn
await session.send({ prompt: "Next, add tests" });

Limitations du protocole

Le Kit de développement logiciel (SDK) peut accéder uniquement aux fonctionnalités exposées via le protocole JSON-RPC de l’interface CLI. Si vous avez besoin d’une fonctionnalité CLI qui n’est pas disponible :

Recherchez les alternatives : De nombreuses fonctionnalités ont des équivalents du SDK (voir Solutions de contournement ci-dessus).
Utilisez directement l’interface CLI : Pour les opérations ponctuelles, appelez l’interface CLI.
Demandez la fonctionnalité : Ouvrez un problème dans le dépôt github/copilot-sdk pour demander la prise en charge du protocole.

Compatibilité des versions

Portée de protocoles SDK	Version du protocole CLI	Compatibilité
v2-v3	v3	Prise en charge complète
v2-v3	v2	Pris en charge par les adaptateurs v2 automatiques

Le Kit de développement logiciel (SDK) négocie les versions du protocole avec l’interface CLI au démarrage. Le SDK prend en charge les versions de protocole 2 à 3. Lors de la connexion à un serveur CLI v2, le SDK adapte automatiquement les messages tool.call et permission.request au modèle d’événement v3, sans qu’aucun changement de code ne soit nécessaire.

Vous pouvez vérifier les versions au moment de l’exécution :

TypeScript

const status = await client.getStatus();
console.log("Protocol version:", status.protocolVersion);

const status = await client.getStatus();
console.log("Protocol version:", status.protocolVersion);

Compatibilité du Kit de développement logiciel (SDK) et de l’interface

Qui peut utiliser cette fonctionnalité ?

Dans cet article

Comparaison des fonctionnalités

Disponible dans le Kit de développement logiciel (SDK)

Non disponible dans le Kit de développement logiciel (CLI uniquement)

Solutions de contournement

Exportation de session

Contrôle d’autorisation

Suivi de l’utilisation des jetons

Compactage de contexte

Gestion du plan

Direction des messages

Limitations du protocole

Compatibilité des versions