İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Skill oluşturma

Bir Skill oluşturmanın üç yolu: talimatları elle yazmak, sohbetle üretmek veya bir Markdown dosyası ya da ZIP paketi yüklemek.

Skill oluşturmak için Member rolü veya üstü gerekir. Üç oluşturma yöntemi vardır.

Yöntem 1: Talimatları elle yazma

Kenar çubuğunda Skills'e gidin, Add Skill'e tıklayın, ardından Write skill instructions'ı seçin.

Aşağıdaki alanları doldurun:

AlanZorunluLimitAçıklama
NameYes64 charactersKısa, okunabilir bir başlık; örneğin "Weekly Status Report".
HandleNo100 charactersSkill'in dahili tanımlayıcısı. Addan küçük harf, rakam ve tirelerle otomatik üretilir. Gerektiğinde elle ayarlayabilirsiniz.
DescriptionNo1,024 charactersBu Skill'in ne zaman kullanılacağını anlatan bir veya iki cümle. Yapay zekâ Skill'i etkinleştirip etkinleştirmemeye bu alana bakarak karar verir.
InstructionsYes50,000 charactersAsıl içerik: ne yapılacağı, çıktının nasıl biçimlendirileceği, nelerin dahil edilip kaçınılacağı. Düz metin veya Markdown.
IntegrationsNoİsteğe bağlı olarak, bu Skill aktifken eylemleri kullanılabilir olacak entegrasyonları ekleyin. Bkz. Skill'ler ve entegrasyonlar.

Açıklama alanı

Açıklama kritiktir. Yapay zekâ her mesajda bu Skill'in ilgili olup olmadığına karar vermek için onu okur. Belirsiz bir açıklama Skill'in yanlış zamanda etkinleşmesine veya hiç etkinleşmemesine yol açar.

Örnek
Too vagueStatus reports.
EffectiveUse when asked for a status update, progress summary, or weekly report.

Açıklamayı, bir meslektaşınıza bu Skill'e ne zaman başvurmaları gerektiğini anlatıyormuş gibi yazın. Somut tetikleyici ifadeler ekleyin.

Yöntem 2: Sohbetle oluşturma

Skills'e gidin, Add Skill'e tıklayın, ardından Create with chat'i seçin. Düz dilde ne istediğinizi anlatın; ajan sizin için ad, açıklama ve talimatları üretir.

Talimatları nasıl ifade edeceğinizden emin değilseniz en hızlı başlangıç noktası budur. Kaydetmeden önce yapay zekânın ürettiği her şeyi gözden geçirip düzenleyebilirsiniz.

Konuşmadaki dosyalar destekleyici dosya olabilir. ajan'dan yüklediğiniz ekleri veya sohbette ürettiği dosyaları eklemesini isteyin. Her istek en fazla 20 dosya kopyalar; dosya başına 5 MB limiti vardır.

Yöntem 3: Markdown dosyası veya ZIP paketi yükleme

Destekleyici dosyası olmayan bir Skill oluşturmak için bir Markdown dosyası yükleyin. Destekleyici dosyalar içeren Skill'ler için içinde SKILL.md olan bir .zip arşivi yükleyin.

Skills'e gidin, Add Skill'e tıklayın, ardından Upload a skill'i seçin ve dosyanızı sürükleyin.

Markdown dosya formatı

Markdown dosyasının üstünde bir YAML frontmatter bloğu olmalıdır:

markdown
---
name: Weekly Status Report
slug: weekly-status-report
description: Use when asked for a status update, progress summary, or weekly report.
---

Summarize recent work in three sections: **Wins**, **Blockers**, and **Next steps**.
Keep the tone professional but concise.
Each section should contain 3 to 5 bullet points.

Frontmatter alanları:

AlanZorunluAçıklama
nameYesGörünen ad, en fazla 64 karakter.
slugNoHandle. Verilmezse addan otomatik üretilir. Yalnızca küçük harf, rakam ve tire.
descriptionNoEn fazla 1.024 karakter.
licenseNoİsteğe bağlı lisans alanı.

Talimat gövdesi (frontmatter bloğundan sonraki içerik) zorunludur.

ZIP paketi

Bir ZIP arşivi, SKILL.md dosyası ile birlikte betikler, referanslar veya varlıklar gibi destekleyici dosyalar içerebilir.

Yapı: SKILL.md arşivin kökünde veya tek bir üst düzey dizin içinde olmalıdır.

İzin verilen dosya türleri: .md, .mdx, .txt, .py, .sh, .js, .ts, .json, .yaml, .yml, .toml, .csv, .xml, .xsd, .html, .css, .svg, .pdf, .docx, .xlsx, .pptx, .png, .jpg, .jpeg, .gif, .webp

Boyut limitleri:

LimitDeğer
ZIP file size25 MB
Uncompressed total20 MB
Individual file5 MB
Maximum file count200 files

Mevcut bir Skill'i düzenleme

Skills'e gidin ve ayrıntı görünümünü açmak için bir Skill seçin. Skill'i düzenleyebiliyorsanız şunları güncelleyebilirsiniz:

  • Başlıkta Name and icon.
  • SKILL.md dosyasını açıp Edit skill'e tıklayarak Description and instructions.
  • Yeni dosya ve klasör ekleyerek veya dosya yükleyerek Supporting files. Mevcut destekleyici dosyaları düzenleyebilir, yeniden adlandırabilir, taşıyabilir veya silebilirsiniz.
  • Edit integrations'a tıklayarak Integrations.

Bu seçenekler içe aktarılmış Skill'ler için de geçerlidir. SKILL.md ana talimat ve meta veri dosyası olarak kalır; yeniden adlandırılamaz, taşınamaz veya silinemez. Diğer Markdown dosyaları farklı adlar kullanabilir.

Sohbetten de destekleyici dosya ekleyebilirsiniz. ajan'dan konuşma eklerini oluşturduğunuz bir Skill'e kopyalamasını isteyin. Mevcut bir yola kopyalanan dosya önceki sürümü değiştirir.

İyi talimat yazma

Bir Skill'in kalitesi neredeyse tamamen talimatlarının kalitesine bağlıdır.

  • Çıktı konusunda spesifik olun. "summarize things" demeyin. Şunu deyin: "write a three-section summary with: (1) key decisions made, (2) open questions, (3) next steps. Each section should be 3 to 5 bullet points."
  • Açıklamayı yeni bir meslektaşa anlatıyormuş gibi yazın. Belirsiz açıklamalar yapay zekânın Skill'i yanlış zamanda etkinleştirmesine veya hiç etkinleştirmemesine yol açar.
  • Paylaşmadan önce test edin. Skill'i kurun, yeni bir sohbet başlatın ve yapay zekânın beklediğiniz gibi davranıp davranmadığına bakın. Gözlemlerinize göre ayarlayın.
  • Talimatları odaklı tutun. Bir şeyi iyi yapan bir Skill, birçok durumu kapsamaya çalışan birinden daha güvenilirdir.
  • Açıklamaya somut tetikleyici ifadeler ekleyin. Örnekler: "when asked for updates," "when drafting a reply to a customer," "when summarizing a meeting."

Sınırlamalar

NeLimit
Active Skills per user30
Workspace-applied Skills8
Skill name64 characters
Description1,024 characters
Instructions50,000 characters
ZIP file size25 MB
Uncompressed bundle size20 MB
Files copied to a Skill per chat request20

Skill'lerin yapamayacakları:

  • Skill'lerin oturumlar arası belleği yoktur. Talimatlar her konuşmanın başında yeniden okunur. Kalıcı bellek için Chat Memory kullanın.
  • Skill'ler kendi başlarına canlı veriye erişemez. Bir entegrasyona bağlı değilse Skill yalnızca talimat sağlar ve gerçek zamanlı bilgi çekmez.
  • Sürüm geçmişi yoktur. Bir Skill'in talimatlarını güncellediğinizde önceki sürüm kaydedilmez.

SSS

Gelecekteki sohbetleri yönlendirmesi gereken yeniden kullanılabilir talimatlarınız olduğunda bir Skill oluşturun. Skill'ler tekrarlanabilir iş kalıpları, yazım kuralları, alan bağlamı veya tam bir ajan gerektirmeyecek kadar küçük dahili süreçler için en uygundur.

Talimatların spesifik, kapsamlı ve test edilebilir olup olmadığını kontrol edin. Tek bir Skill'te çok fazla ilgisiz hedef karıştırmaktan kaçının ve geniş paylaşmadan önce gerçekçi istemlerle test edin.