Yetenekler

Yetenekler (Skills), LibreChat Ajanları için yeniden kullanılabilir talimat paketleridir. Bir yetenek, bir SKILL.md dosyası etrafında şekillenir: frontmatter, yeteneğin ne zaman kullanılması gerektiğini açıklar; markdown gövdesi ise ajana izlemesi gereken prosedürü, kuralları, örnekleri veya referansları sunar.

Beceriler, aşağıdakiler gibi tekrarlanabilir işler için kullanışlıdır:

• Marka veya yazım kılavuzlarını uygulama
• Dahili inceleme kontrol listelerini takip etme
• Standart bir araştırma iş akışını çalıştırma
• Özelleştirilmiş bir araç iş akışını hazırlama
• Yeniden kullanılabilir betikleri, referansları ve varlıkları bir talimat dosyasıyla paketleme

Becerileri Etkinleştir

skills aracı yeteneği varsayılan olarak etkindir. Yöneticiler, Skills özelliğini kullanıcılardan gizlemek için bunu agents uç noktası yetenek listesinden kaldırabilirler.

endpoints:
  agents:
    capabilities:
      - 'deferred_tools'
      - 'execute_code'
      - 'file_search'
      - 'web_search'
      - 'artifacts'
      - 'subagents'
      - 'actions'
      - 'context'
      - 'skills'
      - 'tools'
      - 'chain'
      - 'ocr'

Rol izinleri ayrıca kimlerin yetenekleri kullanabileceğini, oluşturabileceğini, paylaşabileceğini ve herkese açık olarak paylaşabileceğini kontrol eder.

Dağıtım Becerileri

Yöneticiler, DEPLOYMENT_SKILLS_DIR kullanarak dosya sisteminden salt okunur Skills dağıtabilirler.

DEPLOYMENT_SKILLS_DIR=./skill

Dizin varsayılan olarak proje kök dizinindeki ./skill yoludur. LibreChat, dağıtım Skill'lerini başlangıçta yükler ve bunları Skills özelliği etkinleştirilmiş kullanıcılara sunar.

Dağıtım Becerileri:

• UI'da salt okunurdur
• Kaynak olarak deployment kullanın
• Aynı isme sahip kalıcı Skills üzerinde öncelik kazanır
• Dosyalar eklendiğinde, kaldırıldığında veya değiştirildiğinde bir LibreChat yeniden başlatması gerektirir

GitHub Skill Sync

Yöneticiler, librechat.yaml içindeki skillSync.github ayarını kullanarak GitHub depolarındaki Skills öğelerini yansıtabilirler.

skillSync:
  github:
    enabled: true
    intervalMinutes: 60
    runOnStartup: true
    sources:
      - id: librechat-skills
        owner: your-org
        repo: your-skills-repo
        ref: main
        paths:
          - skills
        skillDiscoveryDepth: 2
        token: '${GITHUB_SKILLS_TOKEN}'

GitHub Skill Sync:

• SKILL.md için yapılandırılmış depo yollarını tarar
• Her bir yeteneğin yanındaki paketlenmiş dosyaları içe aktarır
• source: "github" ile yansıtılan Becerileri (Skills) depolar
• Yukarı akış deposu değiştiğinde yansıtılan Skills'i günceller
• Artık yapılandırılmış kaynakta bulunmayan yansıtılmış (mirrored) Skills'i kaldırır
• Zamanlanmış, başlangıçta ve manuel yönetici tetiklemeli çalıştırmaları destekler

Seçili depo için salt okunur (read-only) Contents ve Metadata izinlerine sahip bir GitHub fine-grained personal access token kullanın. Tüm alanlar, kimlik bilgisi seçenekleri, kiracı kapsamı (tenant scoping) ve yönetici senkronizasyon uç noktaları için Skill Sync Object Structure bölümüne bakın.

Bir Skill Oluşturun

Yan panelden Skills kısmını açın. Bir skill'i doğrudan LibreChat içinde yazabilir veya SKILL.md içeren bir .md, .zip ya da .skill dosyası yükleyebilirsiniz.

Minimum SKILL.md:

---
name: brand-guidelines
description: Use when writing public-facing content that must follow the company voice and terminology.
---

# Brand Guidelines

Write in a concise, practical tone.
Prefer active voice.
Use product terminology consistently.

Frontmatter

Çağırma Modları

Beceriler bir aracıya üç yolla ulaşabilir:

• Manuel: kullanıcı sohbette $ yazar ve açılır pencereden bir yetenek seçer.
• Model-invoked: model, kendisine sunulan yetenek kataloğundan bir yetenek seçer ve yetenek aracını çağırır.
• Her zaman uygula: özellik etkinleştirildiğinde her adımda devreye girer.

Manuel çağırma, açık bir kullanıcı niyetidir. user-invocable değeri false olmadığı sürece, disable-model-invocation: true ile model çağırmadan gizlenmiş yetenekleri kullanabilir.

Ajan Kapsamı (Agent Scope)

Ajanların kataloğu kullanabilmeleri için önce Yeteneklerinin (Skills) etkinleştirilmiş olması gerekir.

• Eğer kalıcı bir ajan üzerinde skills_enabled değeri false ise veya ayarlanmamışsa, o ajan için yetenekler (skills) devre dışıdır.
• Eğer skills_enabled değeri true ise ve herhangi bir skill allowlist ayarlanmamışsa, ajan kullanıcı tarafından görülebilen tüm aktif kataloğu kullanabilir.
• Eğer skills_enabled değeri true ise ve skills belirli yetenek kimlikleri (skill IDs) içeriyorsa, ajan bu liste ile sınırlandırılır.

Bu, yöneticilerin Skills özelliğini küresel olarak kullanıma sunarken her bir ajanın kullanılabilir yetenek setini odaklanmış tutmasını sağlar.

Etkin ve Paylaşılan Beceriler

Kullanıcılar yetenekleri etkin veya devre dışı olarak değiştirebilirler. Sahip olunan yetenekler varsayılan olarak etkindir. Paylaşılan yetenekler, kullanıcı bunları geçersiz kılana kadar yönetici tarafından yapılandırılan varsayılan ayarı kullanır.

Etkin olmayan beceriler şunlardan hariç tutulur:

• $ açılır penceresi
• Model tarafından çağrılan yetenek kataloğu
• Her zaman uygulanan hazırlama (priming)

Paketlenmiş Dosyalar

Yüklenen yetenek paketleri (skill bundles), SKILL.md dosyasının yanı sıra aşağıdakiler gibi dosyaları da içerebilir:

• references/...
• scripts/...
• assets/...

Arka uç, bu dosyaları yetenekle birlikte depolar. Ajan, yetenek etkin olduğunda ve kapsam dahilinde olduğunda yetenek dosyalarını çözümleyebilir.