Apollia OS s’installe comme n’importe quel logiciel, et laisse derrière lui un programme qui tourne en fond, sans fenêtre : c’est lui qui parle au modèle d’IA, qui exécute les outils, qui applique vos règles et qui compte les étapes.
Trois portes, un seul moteur, et il est sur votre disque.
Le périmètre exact de la préversion
0.2.0-preview · Rust et Python · Apache 2.0 ou MIT
from apollia import agent, skill
from apollia.types import Ctx
@agent(name="veille", version="0.1.0", description="Résume une page pour vous.")
class Veille:
@skill("veille.resumer", description="Résume une page web en cinq points.")
async def resumer(self, url: str, ctx: Ctx) -> str:
page = await ctx.tools.call("web_read", {"url": url})
reponse = await ctx.llm.chat("Résume en cinq points.", page["content"])
return reponse.contentVoici le fichier de l’accroche, cette fois annoté. Ce n’est pas un extrait choisi pour la démonstration, c’est le fichier entier, et chacun de ses morceaux est expliqué en face.
@agent Le décorateur posé sur la classe. Il porte le nom, la version, la description, et ce dont l’agent a besoin pour travailler.
@skill Une capacité, avec son identifiant. Le schéma des paramètres est déduit de la signature de votre méthode.
ctx Le contexte que le runtime glisse dans votre méthode. Quinze services y sont déjà branchés. Vous n’en instanciez aucun.
from apollia import agent, skill
from apollia.types import Ctx
@agent(name="veille", version="0.1.0", description="Résume une page pour vous.")
class Veille:
@skill("veille.resumer", description="Résume une page web en cinq points.")
async def resumer(self, url: str, ctx: Ctx) -> str:
page = await ctx.tools.call("web_read", {"url": url})
reponse = await ctx.llm.chat("Résume en cinq points.", page["content"])
return reponse.contentIl n’y a pas de quatrième pièce, pas de service qui se réveille ailleurs, pas de compte à rattacher. Voici les trois, dans l’ordre où elles comptent pour vous.
Il tient la boucle de l’agent, appelle les outils, relit vos règles à chaque appel et arrête tout à la limite que vous avez posée.
n’écoute que 127.0.0.1Le journal Ce qu’un agent fait est écrit dans un registre en ajout seul, chaîné par hachage et signé. Ce qu’il prouve, et ce qui le borne
Le choix n’engage à rien : les trois portes ouvrent sur le même moteur, avec les mêmes règles et le même journal.
C’est la porte par défaut, celle qui s’ouvre après l’installation et qui vous fait choisir votre modèle. Vous y conversez, vous y branchez vos comptes, vous y réglez ce qu’un agent a le droit de faire et ce qu’il a le droit de retenir.
Le binaire s’appelle apollia-os. Quarante familles de commandes, cent quatre-vingt-dix-neuf commandes invocables, nommées en objet puis verbe, ce qui se devine plus que ça ne s’apprend.
Un drapeau --json, accepté à n’importe quelle position, rend une sortie faite pour être lue par un programme plutôt que par vous.
C’est la porte des intégrateurs, et c’est exactement la même que les deux autres empruntent : l’application et le terminal parlent à cette interface. Cent neuf routes HTTP, décrites par une spécification OpenAPI produite depuis le code plutôt qu’entretenue à côté.
Deux entrées. Un socket de fichier, où ce sont les droits du système qui font le travail. Et le port local 7771, où un jeton est obligatoire, l’équivalent d’un mot de passe.
Une heure de la journée, un intervalle régulier, une seule fois à une date, un fichier qui arrive dans un dossier surveillé, ou un appel entrant dont la signature est vérifiée.
Trois mécanismes, dans l’ordre où ils s’appliquent.
Il s’arrête : réponse rendue, ou limite atteinte.
Votre demande, ce qu’il a déjà fait, et les outils qu’il a le droit d’appeler.
Plutôt que de vous répondre, il réclame un outil.
Vos règles sont relues à cet instant précis. Si aucune ne couvre l’appel, tout s’arrête et attend votre accord.
Il en tire la suite, et il recommence, ou il vous rend sa réponse.
Deux outils échappent à toute simplification : celui qui lance une commande et celui qui exécute du Python. Ceux-là vous sont demandés à chaque fois.
Trois limites, comptées par Apollia et hors de portée de l’agent : le nombre d’étapes, le nombre d’appels d’outils, la durée. Quand l’une atteint zéro, l’exécution s’arrête, finie ou pas. Les chiffres sont ceux de l’exemple ; les vôtres se règlent dans l’application.
Une chose à savoir avant d’installer un agent qui n’est pas de vous : ce point de contrôle couvre la conversation. Un agent installé qui appelle ses outils lui-même ne le rencontre pas. Apollia le borne, il ne l’enferme pas, et la règle pratique tient en une phrase : n’installez que des agents que vous avez écrits, ou dont vous avez lu le code.
Dix-huit outils natifs sont enregistrés au démarrage, et le modèle sait s’en servir dès la première conversation.
| Famille | Outils | Ce qu’ils font |
|---|---|---|
| Vos fichiers | six | Lire, écrire, modifier, lister, chercher par nom ou par contenu. |
| Exécuter du code | deux | Une commande, un script Python. Votre accord à chaque appel. |
| Le web | deux | Une recherche, puis la lecture de la page trouvée. |
| Vos règles | trois | Ajouter, retirer et lister les règles de permission. |
| Les carnets Jupyter | deux | Lire un carnet, en modifier une cellule. |
| Sa mémoire | un | Retrouver ce qu’il a noté, en plein texte. |
| Vous | un | Quand une information lui manque, il vous la demande au lieu de deviner. |
Cinquante et une opérations sur Google Workspace et Microsoft 365. La connexion se fait depuis l’application, en cliquant, et votre mot de passe ne passe jamais par Apollia.
Apollia parle MCP. Dix-huit intégrations arrivent préconfigurées, et le catalogue public du standard se parcourt depuis l’application.
La référence des outils natifs Les comptes, le catalogue, et comment ils se relient
Le kit de développement n’a aucune dépendance tierce : ce que vous installez pour écrire un agent, c’est Python et rien d’autre.
@agent sur la classe Le nom, la version, la description, et ce que l’agent déclare avoir besoin pour travailler.
@skill sur une méthode Une capacité identifiée, appelable par vous, par un déclencheur, ou par un autre agent.
@on_message sur une méthode La réponse dans une conversation, avec l’historique du fil en paramètre.
@orchestrated sur une méthode Pour un agent qui établit un plan avant d’agir plutôt que d’enchaîner ses gestes au fil de l’eau.
Un seul paramètre, ctx, et quinze services derrière. Vous n’en instanciez
aucun, vous n’en configurez aucun, et vous n’avez pas à savoir lequel parle à quoi.
Un produit jeune ne coûte rien. Ce qui coûte, c’est de découvrir sa frontière une fois qu’on a bâti dessus. Voici les quatre qui comptent, dites maintenant plutôt que dans trois semaines.
Un code source, un export comptable, un fil de messages, un contrat, un tableur exporté : tout ce qui est du texte passe, et c’est l’essentiel de ce sur quoi vous travaillez. Les images et les documents scannés sont hors du périmètre de cette version.
Elle cherche en plein texte et classe par pertinence, ce qui la rend exacte et prévisible : vous savez toujours pourquoi un souvenir remonte. Elle ne rapproche pas deux formulations différentes de la même idée, il faut donc lui parler avec les mots qu’elle a vus.
Apollia tourne sous votre compte, avec vos droits, et travaille pour vous seul. Il n’y a pas d’instance partagée entre plusieurs utilisateurs, donc pas de comptes à administrer ni de rôles à distribuer avant de commencer.
Il n’existe pas de bouton pour revenir en arrière sur une action déjà faite. Ce qui vous protège se trouve avant et après : l’accord demandé au moment de l’action, et le journal qui garde la trace de chaque geste.
Le reste, y compris les réponses qui n’arrangent pas le projet, tient sur une page à part, écrite pour être lue avant l’installation plutôt qu’après. Les 23 questions, et nos réponses
Vous en saurez plus en une soirée sur vos propres fichiers qu’en relisant cette page. La page de téléchargement vous dit ce que vous allez rencontrer avant que vous le rencontriez : l’avertissement de sécurité de votre système au premier lancement, les prérequis de votre machine, et le modèle qu’il faudra choisir.
0.2.0-preview · macOS, Windows, Linux · Apache 2.0 ou MIT