Les agents arrivent dans Znosin : API ouverte, commandes et boutons

Znosin accueille les agents : des participants indépendants aux discussions, pilotés par votre service, votre programme ou un modèle IA. Chaque agent possède un nom, un pseudo unique et son propre jeton API. Pour en créer un, ouvrez AgentFather.

Notre espace développeurs est également ouvert. Sa documentation se consulte sans connexion. Les méthodes protégées exigent toujours un jeton : une API ouverte ne rend pas les conversations privées publiques.

Vos services dans une conversation

Un agent peut répondre en privé et travailler dans un groupe, recevoir les messages qui lui sont adressés, envoyer du texte, répondre à un message et modifier ou supprimer ses propres réponses. Les développeurs peuvent télécharger les pièces jointes des messages accessibles à l’agent.

Vous pouvez ainsi concevoir un assistant documentaire, un accueil de demandes ou une interface de discussion pour votre service. Votre programme fournit la logique métier, vérifie les droits de la personne et exécute les actions autorisées.

Créer un agent avec AgentFather

Ouvrez @agentfather et envoyez /newagent. Choisissez un nom et un pseudo disponible se terminant par _agent. Utilisez ensuite le bouton du jeton et confirmez sa création.

Le jeton apparaît séparément de l’historique. Conservez-le sur le serveur de votre programme, jamais dans une page ou un dépôt public. Le gestionnaire permet aussi de lister vos agents, modifier leur profil, renouveler leur jeton, les désactiver ou les réactiver.

Le gestionnaire et la documentation sont disponibles en anglais, russe, ukrainien, allemand, français, polonais et chinois simplifié.

Trouver une commande avec /

Saisissez / dans le champ du message pour afficher les commandes et leurs descriptions. La liste se filtre pendant la saisie. Choisissez avec la souris ou les flèches et Entrée ; la commande est insérée pour ajouter des arguments avant de l’envoyer.

Dans un groupe, le menu précise le destinataire, par exemple /help@support_agent. Les développeurs définissent les menus par langue via l’API. Le propriétaire peut aussi envoyer /setcommands @nickname fr à AgentFather, puis des lignes telles que help - Aide. Chaque langue accepte jusqu’à 20 commandes.

Dans la langue de l’utilisateur

AgentFather répond automatiquement dans la langue de votre interface. /language fr fixe le français et /language auto rétablit le choix automatique. Les sept langues de Znosin sont disponibles.

Pour les agents tiers, les messages entrants et les actions sur les boutons contiennent from.language_code, y compris dans les groupes. Les développeurs peuvent ainsi choisir des réponses et des boutons traduits pour chaque personne. Cette valeur correspond à la langue de l’interface au moment de l’événement ; les anciens événements et les préférences inconnues renvoient null. L’API ne traduit pas automatiquement les textes de votre agent.

Des boutons dans les messages

• Les boutons d’action sous un message transmettent un événement distinct, sans ajouter de message à la discussion.
• Les liens HTTPS ouvrent des sites.
• Les boutons de mini-applications ouvrent leur fiche habituelle et conservent les règles d’accès.
• Les claviers de réponses envoient des messages ordinaires en réponse à l’agent et peuvent se masquer après un choix.

L’agent peut accuser réception avec une notification ou une fenêtre, puis modifier son message et ses boutons. Un transfert de message ne copie pas ses boutons actifs.

Des accès délimités

Le jeton d’un agent indépendant ne donne accès ni au compte de son propriétaire, ni à ses e-mails, ni à son portefeuille. Agir au nom d’une personne relève d’un mécanisme d’autorisation distinct.

En privé, la personne écrit d’abord. Dans les groupes, l’agent reçoit les commandes et les réponses à ses propres messages ; les conversations ordinaires ne sont pas transmises par la file d’événements. L’accès au groupe et au message est vérifié de nouveau lors d’une action sur un bouton.

Les développeurs vérifient également les droits dans leur propre service : une personne peut-elle, par exemple, confirmer cette demande précise ?

Connecter votre code ou votre IA

Choisissez votre langage et votre hébergement. Votre code peut intégrer un modèle que vous hébergez ou un fournisseur IA externe. L’Agent API apporte les événements de conversation et les fonctions de messagerie.

Le guide Agent API décrit les méthodes, les limites et les exemples. Téléchargez aussi la spécification OpenAPI et l’exemple Python avec boutons. Activez callbacks=true pour recevoir les clics. Les événements utilisent le long polling ; les webhooks et l’envoi de pièces jointes ne sont pas encore proposés.

Commencez par /start, /help et un bouton utile.