Dépendances déclarées de DeepSeek Harness : inject et services intégrés
Précédemment, nous avons découvert des plugins qui s'exécutent indépendamment, mais la plupart des plugins dépendent d'autres capacités : registre d'outils, LLM, Agent.
Dans cette section, nous présenterons comment déclarer des dépendances et comment le framework garantit que les dépendances sont prêtes avant l'exécution de apply.
Qu'est-ce qu'un service ?
Un service est une capacité nommée qu'un plugin expose aux autres plugins.
Dans Harness, parmi eux, tools, llm, agents sont tous des Services ; ils sont chargés dans ctx sur : ctx.tools, ctx.llm, ctx.agents.
| Service intégré | De quoi s'agit-il | Utilisation typique |
|---|---|---|
| ctx.tools | Runtime des outils | Enregistrer / Appeler des outils |
| ctx.llm | Service de grand modèle de langage (LLM) | Enregistrer les adaptateurs, initier les requêtes de modèle |
| ctx.agents | Service d'agent | Gérer les sous-agents |
Déclarer les dépendances avec inject
Si votre plugin a besoin d'un service, écrivez-le dans le tableau inject.
Le framework garantit que votre plugin n'est chargé qu'une fois ces services prêts.
Exemple
import type { Context } from '@deepseek-ai/cordis'
export const name = 'my-tool-plugin'
// Déclarer une dépendance : nécessite le service tools
export const inject = ['tools']
export function apply(ctx: Context) {
// Au moment où nous arrivons ici, ctx.tools est garanti prêt.
ctx.tools.register(/* ... */)
}
Lorsque apply est exécuté, tous les services déclarés dans inject sont déjà prêts.
Ceci est garanti par le framework, donc vous n'avez pas besoin d'attendre quoi que ce soit dans votre code.
Dépendance non prête : le plugin attend
Si un service n'est pas prêt, le plugin ne s'exécutera pas.
Sa Fiber restera dans l'état PENDING, en attendant que le service apparaisse.
Dans le cycle de vie, PENDING signifie "déclaré, mais les dépendances requises ne sont pas prêtes."
Si le service n'arrive jamais, le plugin continue d'attendre ; il ne générera pas d'erreur, et apply ne s'exécutera pas.
Dépendances requises et dépendances optionnelles
inject déclare les dépendances requises : le plugin n'est pas chargé lorsque le service est absent.
Si un service est optionnel, utilisez une dépendance optionnelle : ne l'incluez pas dans inject, et interrogez-le avec ctx.get() au moment de l'utilisation.
Exemple
import type { Context } from '@deepseek-ai/cordis'
export function apply(ctx: Context) {
// Le service metrics peut être présent ou non
const metrics = ctx.get('metrics')
// Chaînage optionnel : ignorer s'il n'existe pas, pas d'erreur
metrics?.record('plugin_loaded', 1)
}
Que se passe-t-il lorsqu'un service disparaît ?
Si un service requis disparaît pendant l'exécution (par exemple, le fournisseur est désinstallé), deux choses se produiront.
Premièrement, les plugins qui en dépendent seront automatiquement libérés (libération des ressources).
Deuxièmement, lorsque le service réapparaît, le plugin se recharge automatiquement.
Cela empêche le plugin d'appeler un service qui n'existe plus.
Astuce : cette règle fonctionne avec le nettoyage automatique — le déchargement déclenche le disposeur décrit dans la partie 8.
Résumé et auto-test
Utilisez inject pour déclarer les services requis, et le framework garantit que apply n'est exécuté qu'une fois que les services sont prêts ; interrogez les services optionnels avec ctx.get().
autres extensions1. Que déclare le tableau inject ?
2. Dans quel état se trouve le plugin lorsque les services ne sont pas prêts ?
3. Comment les dépendances optionnelles doivent-elles être déclarées ?