Outils et hôte Python

Le couple X.agent / X.py est normatif. Le programme déclare les capacités ; l’hôte homonyme les implémente.

Déclarer un outil

TOOL isolate_endpoint {
    DESCRIPTION "Isole un poste du réseau."
    INPUT       { host: String BIND suspected_host }
    OUTPUT      { isolated: Symbol }
    SIDE_EFFECT { network.acl, endpoint.connectivity }
    RISK        { operational = HIGH }
    REQUIRES    { endpoint.inspected == yes }
    EFFECT      { threat.status = contained }
    COST        8
}

Champ	Sert à
`INPUT` / `OUTPUT`	vérifier les arguments et borner le résultat attendu
`BIND`	lier un argument à un chemin d’état
`SIDE_EFFECT`	exposer la surface modifiée
`RISK`	alimenter politiques et diagnostics
`REQUIRES`	rendre l’opérateur applicable au planificateur
`EFFECT`	décrire l’état produit pour la planification
`COST`	comparer les routes possibles

Un outil non déclaré n’existe pas. Un argument absent, inconnu ou mal typé est refusé avant le moteur de politiques.

Implémenter l’hôte

endpoint_guard.py

from agentl import Host, MockLLM, Symbol


def build():
    host = Host()

    host.sensors["suspected_host"] = lambda: "PC-042"
    host.sensors["endpoint.inspected"] = lambda: Symbol("yes")

    @host.tool("isolate_endpoint")
    def isolate_endpoint(host: str):
        # appel réel vers votre EDR
        return {"isolated": Symbol("yes")}

    return host, MockLLM()

La fonction build() peut renvoyer (host, llm). Pour une société, elle peut renvoyer des dictionnaires indexés par nom d’agent.

API de l’hôte

Capteurs

Enregistrez une fonction sans argument sous le chemin déclaré dans OBSERVE.

host.sensors["service.http_status"] = probe_status

Outils

Enregistrez une fonction dont les arguments correspondent au contrat INPUT.

host.tools["restart_service"] = restart_service

Approbateur

Affectez host.approver. Seuls True ou un mot d’accord explicite sont acceptés. Toute valeur ambiguë, y compris la chaîne "no", refuse.

host.approver = lambda request: ask_operator(request)

Événements

Injectez une charge utile avec emit; le runtime la récupère via drain.

host.emit("watchdog.alert", severity=Symbol("HIGH"))

Sous-agents

Enregistrez un callable sous le nom du contrat utilisé par DELEGATE.

host.subagents["prober"] = probe_subagent

Garder la frontière honnête

Le test pratique est simple : si une politique de l’entreprise changeait demain, cette ligne Python devrait-elle changer ? Si oui, la décision appartient probablement au .agent.

Rendez des mesures brutes : un code HTTP, un nombre de tentatives, un identifiant. Laissez le programme décider si ces valeurs signifient « sain », « urgent » ou « autorisé ».

Échec fermé

capteur absent : la valeur reste indéterminée ;
outil absent : l’invocation lève une erreur ;
approbateur absent : la demande est refusée ;
LLM absent : MockLLM permet de conserver un flux déterministe lorsqu’il convient.

Analyser la frontière

Détectez les comparaisons, filtres et seuils métier cachés dans l’hôte.

Commencer

Construire avec le Core

Vérifier et exploiter

Outils et hôte Python

Déclarer un outil

Implémenter l’hôte

API de l’hôte

Garder la frontière honnête

Échec fermé

Analyser la frontière

​Déclarer un outil

​Implémenter l’hôte

​API de l’hôte

​Garder la frontière honnête

​Échec fermé

Analyser la frontière

Déclarer un outil

Implémenter l’hôte

API de l’hôte

Garder la frontière honnête

Échec fermé