Znosin unterstützt jetzt Agenten: eigenständige Chatteilnehmer, hinter denen Ihr Dienst, Ihr Programm oder ein KI-Modell arbeitet. Jeder Agent erhält einen Namen, einen eindeutigen Nickname und einen eigenen API-Token. Die Erstellung beginnt bei AgentFather.
Auch der Entwicklerbereich ist verfügbar. Die Dokumentation lässt sich ohne Anmeldung lesen. Geschützte API-Methoden benötigen weiterhin einen Token; eine offene API macht private Unterhaltungen nicht öffentlich.
Eigene Dienste im Chat
Agenten können in privaten Chats antworten und in Gruppen arbeiten, an sie gerichtete Nachrichten empfangen, Text senden, auf Nachrichten antworten und eigene Antworten bearbeiten oder löschen. Entwickler können Anhänge aus Nachrichten herunterladen, auf die der Agent Zugriff hat.
Damit lassen sich beispielsweise ein Assistent für Unternehmenswissen, eine Anfrageannahme oder eine Chatoberfläche für einen bestehenden Dienst bauen. Die Geschäftslogik kommt aus Ihrem Programm: Es prüft die Rechte der Person und führt die erlaubte Aktion aus.
Mit AgentFather starten
Öffnen Sie @agentfather und senden Sie /newagent. Wählen Sie einen Namen und einen verfügbaren Nickname mit der Endung _agent. Drücken Sie anschließend die Token-Schaltfläche und bestätigen Sie die Ausstellung.
Der Token erscheint getrennt vom Chatverlauf. Bewahren Sie ihn auf Ihrem Server auf, nicht in öffentlichen Webseiten oder Quellcode-Repositories. Über den Manager können Sie Agenten auflisten, Profile bearbeiten, Tokens erneuern und Agenten deaktivieren oder wieder aktivieren.
Manager und Dokumentation sind auf Englisch, Russisch, Ukrainisch, Deutsch, Französisch, Polnisch und vereinfachtem Chinesisch verfügbar.
Befehle entdecken
Geben Sie / in das Nachrichtenfeld ein. Ein Menü zeigt passende Befehle und Beschreibungen und filtert sie während der Eingabe. Wählen Sie mit Maus oder Pfeiltasten und Enter; ergänzen Sie anschließend bei Bedarf Argumente und senden Sie den Befehl.
In Gruppen ergänzt das Menü den Empfänger, etwa /help@support_agent. Entwickler registrieren sprachabhängige Menüs über die API. Eigentümer können auch /setcommands @nickname de an AgentFather senden, gefolgt von Zeilen wie help - Hilfe. Pro Sprache sind bis zu 20 Befehle möglich.
In der Sprache des Benutzers
AgentFather antwortet automatisch in der Sprache Ihrer Oberfläche. /language de legt Deutsch fest, /language auto aktiviert wieder die automatische Auswahl. Alle sieben Znosin-Sprachen werden unterstützt.
Bei eigenen Agenten enthalten eingehende Nachrichten und Schaltflächenaktionen das Feld from.language_code, auch in Gruppen. Entwickler können damit übersetzte Antworten und Schaltflächen für jede Person auswählen. Der Wert beschreibt die Oberflächensprache zum Zeitpunkt des Ereignisses; ältere Ereignisse und unbekannte Präferenzen liefern null. Die API übersetzt die Texte Ihres Agenten nicht automatisch.
Schaltflächen für den nächsten Schritt
- Aktionsschaltflächen unter einer Nachricht senden ein separates Ereignis, ohne eine neue Chatnachricht zu erzeugen.
- HTTPS-Links öffnen Webseiten.
- Mini-App-Schaltflächen öffnen die normale App-Detailansicht; bestehende Zugriffsregeln bleiben erhalten.
- Antworttastaturen neben dem Eingabefeld senden normale Antworten an den Agenten und können nach einer Auswahl verschwinden.
Ein Agent kann eine Aktion mit einer kurzen Benachrichtigung oder einem Dialog bestätigen und seine Nachricht samt Schaltflächen aktualisieren. Weitergeleitete Nachrichten übernehmen keine aktiven Agent-Steuerelemente.
Begrenzter Zugriff
Der Token eines eigenständigen Agenten öffnet weder das Konto des Eigentümers noch dessen E-Mail oder Wallet. Aktionen im Namen einer Person verwenden ein separates Berechtigungssystem.
Im privaten Chat schreibt die Person zuerst. In Gruppen erhält der Agent Befehle und Antworten auf seine Nachrichten; normale Gruppengespräche werden nicht über die Ereigniswarteschlange ausgeliefert. Bei Schaltflächenaktionen werden Chat- und Nachrichtenzugriff erneut geprüft. Entwickler müssen zusätzlich die Rechte in ihrem eigenen Dienst prüfen.
Code oder KI verbinden
Sie wählen Programmiersprache und Hosting. Ein eigenes KI-Modell oder ein externer Anbieter lässt sich in Ihrem Programm anbinden; die Agent API stellt die Chatereignisse und Nachrichtenfunktionen bereit.
Die Agent-API-Anleitung enthält Methoden, Grenzen und Beispiele. Hinzu kommen die OpenAPI-Spezifikation und ein Python-Beispiel mit Schaltflächen. Aktivieren Sie callbacks=true für Klickereignisse. Ereignisse werden per Long Polling zugestellt; Webhooks und das Hochladen ausgehender Anhänge sind noch nicht enthalten.
Beginnen Sie mit /start, /help und einer nützlichen Schaltfläche.
ZnosinAlle Neuigkeiten →