06/Documentation
Telefonda dayanıklı aracılar
Dayanıklı bir aracının bölümünün, konuşmalarının, sorularının ve alındılarının nasıl göründüğü
Deneysel. Bir durable agent'ın telefonda gösterdiği şeyler değişebilir veya özellik daha sonraki bir alt sürümde kaldırılabilir. Dayanıklı aracılar, kalıp kalmayacağını neyin belirleyeceğini açıklar.
Bu sayfa, bir durable agent'ın telefonunuzda göründüğü her yeri gösterir: gösterge panosundaki satırı, konuşma listesi, soruları, sohbet, başlatıcıları ve push bildirimleri. Dayanıklı aracılar önce bir durable agent bağlar.
Bir durable agent yalnızca hello aşamasında yapabileceğini belirttiği şeyler için bir denetim çizer. Aşağıda bir denetimi adlandıran bir satır, durable agent'ın bunu bildirdiğini varsayar.
Gösterge panosundaki Durable agents bölümü
Her durable agent, alanlarınızdan ayrı olarak bir Durable agents bölümünde tek bir satırdır.

| satırın bir kısmı | gösterdiği şey |
|---|---|
| 1. Satır | sources.json içindeki durable agent adı ve bir Deneysel rozeti |
| 2. Satır | Çalışma zamanı, durable agent'ın kendi hello mesajında kendine verdiği ad, aksi takdirde durable. Ardından local veya remote |
| Sağ kenar, hazır | Açık konuşmalarının sayısı ve sizi bekleyenlerin sayısı (needs-you renginde). İkinci sayı sıfırken gizlenir |
| Sağ kenar, hazır değil | Starting, Unreachable veya Version mismatch kelimesi ve sayı yok |
Soketi üzerinden veya http://127.0.0.1 ya da http://localhost üzerinden erişilen bir durable agent local durumundadır. Diğer tüm URL'ler remote durumundadır.
Bu bölüm alanlarınızın altında yer alır. Herhangi bir durable agent sizi bekleyen bir konuşmaya sahip olduğunda alanların üstüne taşınır, sonuncusu yanıtlandığında ise tekrar alta döner. Bağlı bir durable agent yoksa bu bölüm hiç çizilmez.
"Yalnızca size ihtiyaç duyan panelleri göster" etkinken, bu bölüm yalnızca sizi bekleyen durable agent'ları listeler. O durable agent'ın konuşma listesini açmak için herhangi bir durumdaki bir satıra dokunun.
Konuşma listesi
Bir durable agent'ın ana sayfası, bir mesajlaşma uygulamasının sohbetleri listelediği gibi konuşmalarını listeler.

Önce sizi bekleyenler gelir, ardından en yeniden başlayarak diğer açık konuşmalar sıralanır. Kapatılanlar Kapalı etiketi altında devam eder. Her satırda başlık, durum işareti, son etkinliğin saati ve altında bir satır gösterilir: bekleyen soru, aksi takdirde durable agent'ın alt başlığı. Bekleyen bir satır ayrıca açık sorularını da sayar. Başlığı olmayan bir satırda "Başlıksız konuşma" yazar.
Chat içinde açmak için açık bir satıra dokunun. Salt okunur olarak okumak için kapalı bir satıra dokunun. Durable agent bir konuşmayı yeniden açabiliyorsa, kapalı bir konuşmada Yeniden aç düğmesi bulunur.
Açık satırlar panonun kendi verilerinden gelir, bu nedenle hemen çizilirler. Kapatılanlar ise Collie'nin her yoklamada değil, ziyaret başına bir kez ve bir konuşma açıldığında veya kapandığında tekrar sorduğu durable agent'tan gelir.
| listenin altında | şu durumda: |
|---|---|
| Daha fazla yükle | Durable agent'ın 100'den fazla konuşması var. Her dokunuş sonraki 100 konuşmayı okur |
| "Bu durable agent konuşmalarının bir listesini tutmuyor." | Durable agent liste tutmadığını yanıtladı |
| "Durable agent yanıt vermedi. Birazdan tekrar deneyin." | Durable agent okuma isteğine yanıt vermedi |
| "Durable agent wire v2 kullanıyor, bu Collie ise v1 kullanıyor. Collie'yi veya agent'ın SDK'sını güncelleyin." | Collie, wire sürümü (Makbuzlar) nedeniyle durable agent'ı reddetti |
| "Konuşmalar yüklenemedi. Tekrar deneyin." | Okuma işlemi aktarım sırasında başarısız oldu |
Geçmiş tutmayan bir durable agent, açık konuşmalarını Kapalı grubu ve not olmadan tek başına gösterir. Önceden çizilmiş bir liste, sonraki bir okuma başarısız olduğunda çizili kalır.
Telefonda bir soru
Bir durable agent'ın sorusu, sohbette ilgili olduğu araç çağrısının altında bir karttır.

Başlık durable agent'ı belirtir: "Yanıtınız gerekiyor · desk". Durable agent bir süre sonu belirlediğinde, başlığın altındaki satır geri sayım yapar: "4 dk içinde süresi doluyor", ardından "40 sn içinde süresi doluyor", ardından "Süresi doldu". Süre sonundan sonra düğmeler kalır ve geç bir dokunmayı durable agent kendisi yanıtlar.
| tür | kartın gösterdiği | sınırlar |
|---|---|---|
permission | Seçenek başına bir düğme, Collie'nin ifadeleriyle: İzin ver, Her zaman izin ver, Reddet veya İptal et. Durable agent'ın kendi etiketi daha silik olan ikinci satırdır | En fazla 6 seçenek |
choice | Seçenek başına bir satır. Tek dokunma seçimi gönderir. multiple ile satırlar "İstediğiniz sayıda seçin" altında açılıp kapanır ve Gönder seçilenleri iletir | En fazla 8 seçenek |
text | Yazmak için bir satır, "12 / 500" gibi bir sayaç ve Gönder | 500 karakter veya durable agent'ın en fazla 2000'e kadar olan sınırı |
form | Tek bir Gönder altında sıralanmış alanları: bir metin satırı, aralarından seçim yapılacak bir liste olarak bir seçenek veya bir açma-kapatma anahtarı. Zorunlu bir alanda Zorunlu yazar | En fazla 6 alan |
"Her zaman izin ver" iki dokunma gerektirir. İlki düğmeyi "Her zaman izin vermek için tekrar dokunun" ve aracın adına dönüştürür. İkincisi gönderir. Soru bir araç belirtmediğinde Collie bunu sunmaz.
Collie durable agent'ın ifadelerini kesmek veya temizlemek zorunda kaldığında, kartta "Metin kısaltıldı" yazar ve tüm metin size gösterilmediği için "Her zaman izin ver" seçeneğini sunmaz.
Bu Collie'nin tanımadığı türde bir kart kendi ifadelerini gösterir ve "Bu istek telefondan yanıtlanamaz." der. Bir konuşma ilk 5 sorusunu kart olarak çizer ve "N tane daha göster" satırı geri kalanları açar.
Bir dokunmadan sonra ne olur
Her dokunma bir istek kimliği taşır ve yalnızca bir dokunma yanıt gönderir.
| ne oldu | kartta ne yazıyor | ne yapılmalı |
|---|---|---|
| Durable agent yanıtı aldı | Hiçbir şey: kart kapanır | Hiçbir şey |
| Önce durable agent karar verdi | "Durable agent içinde karar verildi." | Hiçbir şey. Sohbet bunun için bir satır tutar |
| Soru önce zaman aşımına uğradı | "Bir yanıttan önce zaman aşımına uğradı." | Hiçbir şey. Sohbet bunun için bir satır tutar |
| Önce başka bir yanıt geldi | "Zaten yanıtlandı. Bu kart sonraki güncellemede kaybolur." | Hiçbir şey |
| Soru açık değildi ve durable agent nedenini belirtmedi | "Alınmadı. Soru birazdan tekrar gösterilebilir." | Bekleyin. Yeniden başlayan bir durable agent tekrar sorar |
| Soru siz işlem yaparken değişti | "Bu talep değişti. Tekrar okuyun, ardından bir yanıta dokunun." | Yeni formu okuyun ve tekrar dokunun |
| Yanıt ulaşmamış olabilir | "Yanıtın ulaştığından emin olunamadı. Yeniden dene bunu bir kez daha gönderir." | Yeniden dene'ye dokunun. Aynı istek kimliğini gönderir, böylece durable agent durumdan bir kez haberdar edilir |
| Yeniden deneme sorunun kapatıldığını veya değiştirildiğini tespit etti | "Zaten uygulanmış olabilir. Sohbeti kontrol edin." | Sohbeti kontrol edin |
| Collie yanıtı reddetti | Collie'nin gerekçesi, aksi halde "Yanıt reddedildi." | Gerekçeyi okuyun |
| Durable agent makinesinde daha eski bir Collie çalışıyor | "Bu makine daha eski bir Collie çalıştırıyor ve yanıtları burada kabul edemiyor. Makineyi güncelleyin veya durable agent içinde yanıtlayın." | O makineyi güncelleyin |
Makbuzlar
Collie, yanıtlamadığınız bir sorunun nasıl sonlandığını ve bir durable agent'ın neden reddedildiğini bildirir.

| durum | gördüğünüz şey |
|---|---|
| Sorunun bir son kullanma süresi var | Kart, başlığının altında kalan süreyi gösterir |
| Durable agent karar verdikten sonra veya süre dolduktan sonra dokundunuz | Kart donar ve "Durable agent içinde kararlaştırıldı." ya da "Bir yanıttan önce zaman aşımına uğradı." iletisini gösterir |
| Bir soru zaman aşımına uğradı veya siz dokunmadan durable agent tarafından karara bağlandı | Sohbette tek bir satır: "Timed out before an answer:" veya "Decided in the durable agent:", ardından sorunun başlığı |
| Collie, hat sürümü nedeniyle durable agent'ı reddetti | Durable agent'ın ana sayfasında bir uyarı kutusu ve gösterge paneli satırında Version mismatch ifadesi |
Telefondan yanıtladığınız bir soru veya sırayı durdurduğunuz için sonlanan bir soru böyle bir satır bırakmaz. Dokunmanız zaten kendi kartına sahipti.

Uyarı kutusu her iki tarafın hangi hat sürümünü konuştuğunu belirtir; örneğin "Program speaks wire v2, this Collie speaks v1. Update Collie, or the durable agent's SDK." Daha eski olan tarafı güncelleyin. Kural Sürümler içinde yer alır.
Sohbet
Bir durable agent'ın görüşmesi, tek görünümü olan Chat içinde açılır.
| durable agent'tan gelen öge | Chat'in çizdiği içerik |
|---|---|
user | Kendi satırınız |
reply | Agent'ın yanıtı |
thinking | Agent'ın düşünce süreci |
notice | Yazışmada kısa bir not |
markdown | İşlenmiş markdown: başlıklar, listeler, vurgular, kodlar ve bağlantılar. Ham HTML metin olarak gösterilir |
code | Durable agent belirttiğinde diliyle birlikte bir kod bloğu |
link | Etiketiyle birlikte bir bağlantı satırı, aksi halde adres. Yalnızca https:// bağlantıları |
tool | Bir araç çağrısı: çalışıyor, çıktısıyla tamamlandı, başarısız veya reddedildi |
Halen genişlemekte olan bir reply, thinking, notice veya markdown ögesinin sonunda bir imleç bulunur ve zaman bilgisi yer almaz. İmleç nihai metin ulaştığında kaybolur. Durdurduğunuz bir sıra "stopped" notunu bırakır.
Kendi satırınız
Satırınız Send düğmesine dokunduğunuz anda küçük bir saat simgesiyle birlikte yazışmada görünür. Durable agent'ın kendi kopyası ulaştığında satırın yerini alır.
| durum | satırın gösterdiği durum |
|---|---|
| Gönderiliyor veya gönderildi | Saat simgesi. Durable agent teslim aldığında düzenleyici "Sent" der |
| Yanıt hiç gelmedi | "Sending, not confirmed". Send again aynı request id ile yeniden dener |
| Reddedildi veya sıra ilerledi | "Not sent" ve sözcükleriniz alana geri döner |
Request id değerini yankılamayan bir durable agent, 30 saniye içinde aynı metinle eşleştirilir. Durable agent'ın asla geri yazmadığı bir satır 10 dakika sonra gösterilmeyi bırakır.
Satırınız yazışmadaki en yeni ögeyken ve durable agent henüz yanıt vermemişken, üç noktadan oluşan bir satır çalıştığını belirtir.
Üstbilgi
Üstbilgi iki satırdan oluşur. 1. satır, konuşmanın başlığı ve Deneysel rozetidir.
| 2. satır şunları gösterir: | şu durumda: |
|---|---|
| "Adım 2 / 3: Bir not kaydedin" | Durable agent adımları bildirir ve biri çalışmaktadır |
| "%42: yükleniyor" | Durable agent, etiketiyle birlikte bir yüzde bildirir |
| Durable agent alt başlığı | İlerleme yok veya her adım tamamlandı |
| Çalışma alanı | Durable agent bunların hiçbirini ayarlamaz |
İlerleme yalnızca konuşma çalışırken veya sizi beklerken gösterilir.
Kuşak
Kuşak; Steer, Stop ve ardından durable agent'ın kendi düğmelerinden en fazla 4 tanesini içerir.
Steer, yeni bir tur başlatmak yerine metninizi çalışan tura gönderir. Stop, çalışan turu sonlandırır. Şu anda işlem yapamayan bir düğme yerinde soluklaştırılır, böylece hiçbir şey yer değiştirmez.
| durable agent düğmesi | kural |
|---|---|
| Etiket | En fazla 16 karakter |
| Simge | 12 taneden biri: play, pause, check, x, refresh, archive, flag, star, send, note, search, more. Başka herhangi bir ad simge çizmez |
| Meşgul | Dönen bir simge ve dokunma yok |
| Devre dışı | Soluk ve dokunma yok |
Dokunulduğunda, telefonun gördüğü en yeni turun adı verilir. Konuşma ilerlediyse hiçbir şey çalışmaz ve telefon bunu belirtir: "Konuşma ilerledi, bu nedenle eylem çalıştırılmadı." Kontrol edin, ardından hâlâ istiyorsanız düğmeye tekrar dokunun.
Bir durable agent bölmesinde bulunmayanlar
Durable agent'ın ekranı yoktur; bu nedenle bölmesinde Terminal görünümü, sekme veya bölme şeritleri ve Keys, Type veya Quick düğmeleri bulunmaz. Menüsünde History, Pane settings veya Pin to top row yer almaz. Menüdeki Close seçeneğinde "Close conversation" yazar.
Yeni konuşma ve başlatıcılar
Bir durable agent'ın Yeni sayfası New conversation başlığını taşır ve durable agent'ın başlatıcılarını listeler.
Bir başlatıcı klasör ve metin almaz: nerede çalışacağına durable agent karar verir. Birine dokunun; durable agent yeni bir konuşma açar. Sayfa makineye ait hiçbir agent, kabuk veya komut sunmaz. Başlatıcısı olmayan bir durable agent "This machine's durable agent offers no starters yet." iletisini verir.
Anlık bildirim
Bir soru, her durable agent için belirlenen sınırlar dahilinde telefonunuza bildirim gönderebilir.
| sınır | limit | sınır aşıldığında |
|---|---|---|
| Tek bir bölme | Dakikada 3 bildirim | Soru telefonda gösterilir ve bildirim göndermez |
| Tek bir makinede tek bir durable agent | Dakikada 10 bildirim | Aynısı |
| Tek bir makinede tek bir durable agent | Saatte 30 bildirim | Bir bildirim: "A durable agent on {host} is raising many asks", ardından o durable agent tarafından bir saat boyunca bildirim gönderilmez |
Bildirimde "Permission needed in" ve bölmenin adı yazar. Bir durable agent en fazla 60 karakterlik kendi başlığını ve en fazla 120 karakterlik bir satır ekleyebilir. Collie, bir soruyu makine, durable agent ve araç çağrısı başına bir kez bildirir; bu nedenle yeniden başlatmanın ardından tekrar sorulan bir soru ekranda gösterilir ancak bildirim göndermez. Kalan ayrıntılar Bir durable agent kaynaklı bildirimler içinde yer alır.
Maskeleme
Gizli bilgi maskeleme açıkken (COLLIE_REDACT, varsayılan olarak açıktır), Collie bir durable agent'ın konuşma listesindeki başlıklarda ve alt başlıklarda bulunan gizli bilgileri maskeler.
Bir crew içinde
Lead panosunda, crew'un her makinesi için bir Durable agents bölümü bulunur. Bir üyenin durable agent'ı, 2. satıra üyenin adını ekler (örneğin pi-durable, local, workshop); lead'in kendi durable agent'ları ise hiçbir makine adı belirtmez. Herhangi bir makinedeki bir soru, ilgili bölümü space'lerin üstüne taşır. Kimin neye yanıt verdiğini Bir crew içindeki durable agent'lar belirtir.
Bu sayfayı GitHub üzerinde düzenleyin