Agent belgesi

Agent belgesi, agent'ınızı sade bir dille anlatır: ne yaptığını, neleri aldığını, neleri verdiğini ve sınırlarının nerede olduğunu. Copilot onu kurulum sırasında yazar ve agent değiştikçe güncel tutar. Ekibinizdeki herkes okuyabilir, editörler değiştirebilir; paylaşmak ya da agent'ı başka bir yerde yeniden kurmak için dışa aktarabilirsiniz.

Belge, agent menüsünün ilk öğesi olan Belge sayfasında bulunur.

Belge sayfası

Sayfa belgeyi salt okunur olarak, her bölüm için bir kart hâlinde gösterir.

Öğe	Ne yapar
Alt başlık	Bir şey yazıldıysa Güncellendi: <tarih ve saat>; öncesinde "Bu ajanın ne yaptığı, sade bir dille. Copilot güncel tutar."
Düzenle	Editörler için her bölümde. Bölümü Markdown metni olarak açar. Kaydet saklar; Vazgeç değişikliğini bırakır.
Kimin yazdığı	Her bölüm başlığının yanında: Siz düzenlediniz, Bir ekip arkadaşınız düzenledi ya da Copilot yazdı.
Henüz yazılmadı	Boş bir bölümde görünür (editörler boş bölümleri görür; izleyiciler yalnızca yazılmış olanları).
Ajana uygula	Bir bölümü kaydettikten sonra çıkar. Bkz. Belgeden agent'a.
.md indir	Belgeyi Markdown olarak indirir.
PDF	PDF olarak kaydetmek için yazdırmaya hazır bir sayfa açar.
Test, Copilot	Sağda Test panelini ya da Copilot panelini açar.

Belgesi olmayan bir agent

Ya da boş başlayın ile ya da Belge özelliğinden önce oluşturulan agent'ların belgesi boştur. Sayfada o zaman Henüz belge yok ve editörler için Copilot ile yaz görünür. Bu düğme Copilot'ı şu istek gönderilmeye hazır şekilde açar:

Bu ajanın belgesini şu anki haliyle yaz: talimatlarından, araçlarından, bilgi kaynaklarından, tablolarından ve ayarlarından doldurabildiğin her bölümü doldur.

Gönder'e basın; Copilot bölümleri agent'ın gerçekte sahip olduklarından doldurur.

10 bölüm

Belgede her zaman bu sırayla aynı 10 bölüm bulunur. Her biri sade Markdown'dır ve en fazla 4.000 karakter olabilir.

#	Bölüm	İçine ne yazılır
1	İşletme	İşletmenin kim olduğu, ne sattığı, müşterilerinin kim olduğu, iletişim bilgileri, çalışma saatleri.
2	Görevi	Agent'ın ne için olduğu, birkaç cümleyle.
3	Neler yapabilir	Ele aldığı soru ve görev türleri; skill'leri ve Fonksiyonları sade bir dille.
4	Neler alır	Müşterilerin ona ne söylediği ya da gönderdiği; topladığı bilgiler (tablolar ve alanlar) ve ne zaman topladığı.
5	Neler verir	Yanıtlar ve hangi bilgi kaynağından geldikleri, kaydettiği kayıtlar, mesajlar, otomasyon uyarıları, devretmeler.
6	Sınırlar	Asla söylemediği ya da vaat etmediği şeyler; bilmediğinde ne yaptığı.
7	İnsana devretme	Bir sohbeti ne zaman ekibine devrettiği ve çalışma saatleri dışında ne söylediği.
8	Ton ve diller	Hitap biçimi (siz/siz), diller, üslup.
9	Kanallar	Web sitesi widget'ı, Telegram, API.
10	Açık konular	Hâlâ eksik ya da kararlaştırılmamış olanlar.

Belge yalnızca agent'ın şu an gerçekten yaptığını anlatır, asla planları değil. Fikirler ve yapılacaklar Açık konular'a yazılır.

Copilot belgeyi sizin dilinizde yazar. Bölüm başlıkları Peki panelini kullandığınız dili izler.

Teknik notlar

10 bölümün yanında her belgenin teknik notları vardır: Copilot'ın hangi API'leri neden seçtiği ya da neyi deneyip neden vazgeçtiği gibi teknik notları. En fazla 20.000 karakter.

• Copilot bunları okur ve yazar (Teknik notları güncelledi). Turlar ve günler boyunca kararları hatırlamasına yardım eder.
• Belge sayfasında gösterilmez, dışa aktarımlara asla girmez ve izleyicilerden gizlenir.
• Agent'ınızın Belge özelliğinden önceki Copilot kurulum notları varsa, bunlar değiştirilmeden teknik notlarınıza taşındı.
• Bir Copilot turunu geri almak teknik notları geri almaz.

Nasıl güncel kalır

Copilot her turun başında, her bölümü en son kimin düzenlediğiyle birlikte bütün belgeyi okur.

• Agent'ın ne yaptığını, neleri aldığını ya da neleri verdiğini değiştiren her değişiklikten sonra Copilot ilgili bölümleri kısa ve olgusal biçimde günceller (Belgeyi güncelledi).
• Diğer sayfalarda elle yapılan değişiklikler (örneğin bir talimat bloğunu kendiniz düzenlemeniz) belgeyi arka planda yeniden yazmaz. Copilot bir sonraki çalıştığında agent'ı belgeyle karşılaştırır ve artık uymayan bölümleri güncellemeyi önerir.
• Belge sürümlenmez. Taslağı anlatır ve yayınlanan sürümlerin parçası değildir. Eski bir sürümü geri yüklemek belgeyi geri almaz; ardından Copilot'tan belgeyi güncellemesini isteyin.
• Geri alma, bir Copilot turunun yazdığı bölümleri geri koyar; tur başladıktan sonra bir insan o bölümü düzenlemediyse. Bkz. Geri alma.
• Copilot belgeye yazdığında Belge sayfası kendiliğinden yenilenir.

Dürüst tutun

Agent'ın yapmadığı bir şeyi yapıyor diyen bir belge, hiç belge olmamasından kötüdür. Bir uyumsuzluk fark ederseniz sorun: "Agent'ı Belgeyle karşılaştır ve artık uymayan her şeyi düzelt."

Bölüm ve belge onayları

Düzenlemeleriniz size aittir

Bir insanın (çalışma alanının herhangi bir üyesi ya da bir API anahtarı) yazdığı bölüm korunur. Copilot onu asla sessizce değiştirmez. Değiştirmek istediğinde bir bölüm kartında durur:

• Başlık: "<bölüm>" değişsin mi? ve "Bu bölümü siz yazdınız. Copilot yeni bir metin öneriyor:"
• Sizin metniniz (Sizin) ve Copilot'ınki (Önerilen) yan yana.
• Benimkini koru metninizi olduğu gibi bırakır. Yeni metni kullan onu değiştirir.

Kabul ederseniz bölüm yine sizin sayılır; böylece sessiz değişikliklere karşı korunmaya devam eder. Herhangi bir üyenin düzenlemesi bir bölümü korur ve bu korumanın süresi dolmaz. Kartı kendi sözlerinizle de yanıtlayabilirsiniz; siz seçene kadar hiçbir şey değişmez.

Belgeyi değiştirmek ve bu kartları yanıtlamak editör rolü gerektirir.

Bütün belgeyi onaylamak

Kurulum sırasında Copilot, agent'ı kurmadan önce eksiksiz belgeyi Ajan belgesini onaylayın kartında onaylamanızı ister:

• Agent'ın ne yapacağının kısa bir özeti ve Belgeyi aç.
• Onayla ve kur, Copilot'ın belgeden kurmasını sağlar.
• Değişiklik istemek için mesaj kutusuna yazın. Kart o zaman Henüz onaylanmadı gösterir ve Copilot belgeyi yeniden düzenler.

Bkz. Yeni agent kurulumu.

Belgeden agent'a

Bir bölümü düzenlemek agent'ı değil, belgeyi değiştirir. Agent'ı buna uydurmak için:

1. Bir bölümde Düzenle'ye tıklayın, değiştirin ve Kaydet'e tıklayın.
2. O bölümde çıkan Ajana uygula'ya tıklayın.
3. Copilot paneli "Belgenin "<bölüm>" bölümündeki değişikliğimi ajana uygula." mesajı hazır şekilde açılır. Gönder'e basın.
4. Copilot her zamanki kartları ve testleriyle uygun değişiklikleri yapar (talimatlar, ayarlar, tablolar vb.); her değişiklik geri alınabilir.

Örneğin Sınırlar'ı "İmplant için asla fiyat verme; hekimin muayeneden sonra karar vereceğini söyle" olarak değiştirin, sonra Ajana uygula: Copilot bir talimat bloğu ekler ya da düzenler ve test eder.

Dışa aktarma

Agent'ı açabilen herkes, izleyiciler dâhil, belgesini dışa aktarabilir.

Markdown

.md indir, <agent adı>.md dosyasını indirir. İçinde şunlar bulunur:

• Başlık olarak agent'ın adı.
• Metni olan her bölüm, kendi başlığı altında, Peki panelini kullandığınız dilde.
• Agent'ın taslağından üretilen bir Ek:
  • Araçlar: HTTP araçları, Fonksiyonlar ve skill'ler, ad ve açıklamalarıyla.
  • Tablolar: her tablo alan adlarıyla.
  • Bilgi kaynakları: başlıklarıyla; web sayfaları için sayfa adresiyle (sorgu dizesi ve parça olmadan).
  • Kanallar: widget açıksa Web sitesi widget'ı, bir bot bağlı ve açıksa Telegram.
• Kapanış satırı: "Peki ile oluşturuldu".

Asla dâhil edilmeyenler: teknik notlar, anahtarlar, token'lar ya da gizli bilgiler, araç URL'leri ve kimlik doğrulama ayarları, Fonksiyon kodu, skill adımları.

# Moda Diş Asistanı

## İşletme

Moda Diş, Kadıköy'de bir diş kliniğidir...

## Görevi

Hastaların sorularını yanıtlar ve randevu taleplerini alır...

## Ek

### Araçlar

- randevu_talebi: Bir randevu talebini kaydeder
...

---

Peki ile oluşturuldu

PDF

PDF, belgeyi aynı bölümler ve ekle yeni bir sekmede sade bir sayfada açar ve yüklendiğinde tarayıcının yazdırma penceresini açar. Hedef olarak PDF olarak kaydet'i (ya da sisteminizin karşılığını) seçin.

not

Yazdırma penceresi açılmazsa tarayıcınız yeni sekmeyi engellemiş olabilir. Peki için açılır pencerelere izin verin ve yeniden deneyin.

Taşınabilir bir tanım olarak kullanmak

Dışa aktarılan belge, size ait okunabilir bir plandır. Şunlar için kullanın:

• Paylaşın ve gözden geçirin. Yayınlamadan önce PDF'i bir yöneticiye, hukuk danışmanına ya da müşterinize gönderin.
• Ekibinizi alıştırın. Yeni çalışma arkadaşları Peki panelini açmadan agent'ın ne yaptığını öğrenir.
• Başka yerde yeniden kurun. Markdown; işletmeyi, görevi, girdileri, çıktıları, sınırları, devretmeyi, tonu ve kanalları, ayrıca araç, tablo ve bilgi kaynağı listesini anlatır. Aynı agent'ı başka bir platformda kurmak ya da bir geliştiriciye brif vermek için gereken budur.
• Yeni bir agent'ı tohumlayın. Parçalarını yeni bir agent'ın Copilot sohbetine yapıştırın: "Bu tanımdan bir agent kur: …".
• Kayıt tutun. Büyük değişikliklerden önce agent'ın nasıl çalıştığının bir anlık görüntüsünü saklamak için dışa aktarın.

Bu, insanlar için bir belgedir; başka bir platformun içe aktarabileceği bir dosya değildir: istem metinleri, araç şemaları ya da anahtarlar içermez.

API'den

Belgeye Peki API'si üzerinden de, bir kullanıcı oturumuyla ya da bir API anahtarıyla (Authorization: Bearer <anahtar>) erişilebilir. Yollar https://peki.ai/api temel adresine görelidir. Bkz. API'ye genel bakış ve Kimlik doğrulama.

Yöntem ve yol	Ne yapar
GET /agents/{agentId}/document	Belge: sections (her biri text, updatedAt, updatedBy ile), builderNotes (izleyiciler için boş), updatedAt ve empty.
PUT /agents/{agentId}/document/sections/{key}	Bir bölümü değiştirir. Gövde: {"text": "..."}, en fazla 4.000 karakter. Editör rolü gerektirir. Bütün belgeyi döndürür.
GET /agents/{agentId}/document/export?locale=tr	Markdown dışa aktarımını dosya olarak verir. locale değeri en ya da tr.
GET /agents/{agentId}/document/appendix?locale=tr	Eki JSON olarak verir: tools, tables, knowledge, channels.

Bölüm anahtarları: business, job, capabilities, inputs, outputs, limits, handoff, tone, channels, openItems.

PUT https://peki.ai/api/agents/{agentId}/document/sections/limits
Authorization: Bearer <API anahtarınız>
Content-Type: application/json

{"text": "İmplant için asla fiyat verme. Emin olmadığında ekibin geri aramasını öner."}

API üzerinden yazılan bir bölüm bir insanın yazdığı sayılır; bu yüzden Copilot onu bir bölüm kartı olmadan değiştirmez.

İlgili sayfalar

• Yeni agent kurulumu
• Copilot ile çalışmak
• Copilot'a genel bakış
• Instructions
• Yayınlama ve sürümler
• Üyeler ve roller