W Znosin pojawili się agenci — niezależni uczestnicy czatów obsługiwani przez Twoją usługę, program lub model AI. Każdy ma własną nazwę, unikalny nick i osobny token API. Agenta utworzysz w rozmowie z AgentFather.
Otworzyliśmy też centrum dla deweloperów. Dokumentację można czytać bez logowania. Chronione metody nadal wymagają tokenu: otwarte API nie oznacza publicznego dostępu do cudzych rozmów.
Własna usługa na czacie
Agent może odpowiadać w rozmowach prywatnych i działać w grupach, odbierać kierowane do niego wiadomości, wysyłać tekst, odpowiadać na wiadomość oraz edytować i usuwać własne odpowiedzi. Deweloperzy mogą pobierać załączniki z wiadomości dostępnych agentowi.
Możesz zbudować pomocnika korzystającego z bazy wiedzy, formularz przyjmowania zgłoszeń lub interfejs swojej usługi. Logikę biznesową zapewnia Twój program: sprawdza uprawnienia użytkownika i wykonuje dozwoloną operację.
Utwórz agenta przez AgentFather
Otwórz @agentfather i wyślij /newagent. Podaj nazwę i wolny nick zakończony na _agent. Następnie użyj przycisku tokenu i potwierdź jego wydanie.
Token pojawia się osobno od historii rozmowy. Przechowuj go na serwerze z kodem, a nie na publicznej stronie ani w repozytorium. Menedżer pozwala też wyświetlić listę agentów, zmieniać ich profil, odnawiać tokeny, wyłączać agentów i ponownie ich włączać.
Menedżer i dokumentacja obsługują angielski, rosyjski, ukraiński, niemiecki, francuski, polski oraz chiński uproszczony.
Polecenia po wpisaniu /
Wpisz / w polu wiadomości, aby zobaczyć dostępne polecenia i opisy. Lista filtruje się podczas pisania. Wybierz polecenie myszą albo strzałkami i Enterem; zostanie wstawione do pola, gdzie można dodać argumenty i je wysłać.
W grupach menu dodaje odbiorcę, na przykład /help@support_agent. Deweloper ustawia menu osobno dla każdego języka przez API. Właściciel może także wysłać /setcommands @nickname pl do AgentFather, a następnie wiersze takie jak help - Pomoc. Dla każdego języka można ustawić do 20 poleceń.
W języku użytkownika
AgentFather automatycznie odpowiada w języku Twojego interfejsu. /language pl ustawia polski, a /language auto przywraca wybór automatyczny. Dostępnych jest wszystkich siedem języków Znosin.
Dla zewnętrznych agentów wiadomości przychodzące i kliknięcia przycisków zawierają from.language_code, również w grupach. Programista może wybrać przetłumaczone odpowiedzi i przyciski dla każdej osoby. Wartość oznacza język interfejsu w chwili zdarzenia; starsze zdarzenia i nieznane preferencje zwracają null. API nie tłumaczy automatycznie tekstów Twojego agenta.
Przyciski w wiadomościach
- Przyciski akcji pod wiadomością wysyłają osobne zdarzenie, bez tworzenia kolejnej wiadomości na czacie.
- Linki HTTPS otwierają strony.
- Przyciski miniaplikacji otwierają zwykłą kartę aplikacji i zachowują jej zasady dostępu.
- Klawiatury gotowych odpowiedzi wysyłają zwykłe odpowiedzi do agenta i mogą ukrywać się po jednym wyborze.
Agent może odpowiedzieć na kliknięcie krótkim powiadomieniem albo oknem, a także zmienić własną wiadomość i przyciski. Przekazanie wiadomości nie kopiuje aktywnych przycisków agenta.
Dostęp pod kontrolą
Token niezależnego agenta nie daje dostępu do konta właściciela, poczty ani portfela. Działanie w imieniu użytkownika korzysta z osobnego mechanizmu uprawnień.
W rozmowie prywatnej człowiek pisze pierwszy. W grupach agent otrzymuje polecenia i odpowiedzi na własne wiadomości; zwykłe rozmowy grupowe nie są przekazywane przez kolejkę zdarzeń. Dostęp do czatu i źródłowej wiadomości jest sprawdzany ponownie przy obsłudze przycisków.
Deweloper musi dodatkowo sprawdzić uprawnienia w swojej usłudze, na przykład możliwość potwierdzenia konkretnego zgłoszenia przez daną osobę.
Podłącz swój kod lub AI
Wybierasz język programowania i miejsce uruchomienia. Własny model AI lub zewnętrznego dostawcę podłączasz w swoim kodzie. Agent API dostarcza zdarzenia rozmowy i narzędzia wysyłania wiadomości.
W przewodniku Agent API znajdziesz metody, limity i przykłady. Dostępne są również specyfikacja OpenAPI oraz przykład Python z przyciskami. Włącz callbacks=true, aby odbierać kliknięcia. Zdarzenia są dostarczane przez long polling; webhooki i wysyłanie załączników nie są jeszcze dostępne.
Zacznij od /start, /help i jednego przydatnego przycisku.
ZnosinWszystkie aktualności →