Documentation›Agent en périphérie
Intégrations

Agent en périphérie

certone-agent s'exécute sur une passerelle ou un appareil, surveille un dossier de projet et envoie chaque nouvelle version en analyse confidentielle.

Avant de commencer

  • Python 3.10 ou plus récent sur la passerelle, avec un accès HTTPS sortant vers la plateforme.
  • Une clé d'API member, définie dans CERTONE_API_KEY (ou montée depuis un Secret Kubernetes).

Dans la console CertOne, ouvrez Developer Hub, puis API keys. Nommez la clé, choisissez le rôle member et sélectionnez New key.

  • Copiez le secret immédiatement : il n'est affiché qu'une fois.
  • Les clés commencent par ck_ et expirent après au plus 365 jours.
  • La création de clés exige le rôle admin dans votre organisation.
  • Une clé viewer peut lire les résultats mais ne peut pas soumettre d'analyses.

Installer et surveiller

Installez certone-sdk, qui fournit certone-agent, puis lancez la surveillance. Utilisez --mode confidential : le mode par défaut, local, exécute le moteur sur l'appareil.

Shell
pip install certone-sdk
export CERTONE_API_KEY=ck_...
certone-agent watch --mode confidential --project binpick-sort \
  --asset "Bin-Pick Sorter Vision" --country-code EU --interval 30 \
  --api https://platform.certkor.ai

Options

OptionDéfautRôle
--modelocalUtilisez confidential pour analyser sur la plateforme.
--apirequisLa plateforme CertOne, https://platform.certkor.ai.
--project.Le dossier à surveiller.
--assetLe nom du système d'IA dans CertOne.
--country-codeZZOù le système est exploité.
--teeamd_sev_snpamd_sev_snp ou kata_cc.
--fail-onhighSévérité minimale qui rend le verdict défavorable.
--interval300Secondes entre deux vérifications.
--tokenCERTONE_API_KEYPréférez la variable pour garder la clé hors de la liste des processus.

certone-agent run analyse une seule fois au lieu de surveiller.

Ce que vous voyez

L'agent calcule l'empreinte de tous les fichiers du dossier. Quand elle change, il analyse la nouvelle version :

Journal
certone-agent: watching /home/dev/binpick-sort
certone-agent: Bin-Pick Sorter Vision -> confidential scan aed6... (sha256:...)
certone-agent: verdict FAIL (2 high, 8 medium, 1 low) in ...
certone-agent: new version detected (sha256:...)

Chaque verdict apparaît aussi dans la console, sous le système d'IA.

Comment le contrôle fonctionne

  • watch continue quel que soit le verdict, et reprend une analyse échouée à la vérification suivante.
  • run --mode confidential sort avec 0 si favorable, 1 si défavorable et 2 en cas d'erreur, donc un script de déploiement peut s'arrêter dessus.