2026-04-10 23:20:41 -04:00
---
layout: default
title: "Daha Fazla Yapı landı rma CLI Teknik Özellikleri"
parent: "Turkish (Beta)"
---
2026-04-11 01:08:44 +00:00
# Daha Fazla Yapı landı rma CLI Teknik Özellikleri
2026-04-10 23:20:41 -04:00
> **Beta Translation:** This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.
2026-04-11 01:08:44 +00:00
## Genel Bakı ş
Bu özellik, TrustGraph için gelişmiş komut satı rı yapı landı rma yeteneklerini tanı mlar ve kullanı cı ları n ayrı yapı landı rma öğelerini ayrı ntı lı CLI komutları aracı lı ğı yla yönetmelerini sağlar. Bu entegrasyon, dört birincil kullanı m senaryosunu destekler:
1. **Yapı landı rma Öğelerini Listele** : Belirli bir türdeki yapı landı rma anahtarları nı görüntüleyin
2. **Yapı landı rma Öğesini Al** : Belirli yapı landı rma değerlerini alı n
3. **Yapı landı rma Öğesini Ekle/Güncelle** : Bireysel yapı landı rma öğelerini ayarlayı n veya güncelleyin
4. **Yapı landı rma Öğesini Sil** : Belirli yapı landı rma öğelerini kaldı rı n
## Hedefler
**Ayrı ntı lı Kontrol**: Toplu işlemler yerine bireysel yapı landı rma öğelerinin yönetimini sağlayı n
**Türe Dayalı Listeleme**: Kullanı cı ları n yapı landı rma öğelerini türe göre incelemesine izin verin
**Tek Öğeli İşlemler**: Bireysel yapı landı rma öğelerinin alı nması /eklenmesi/güncellenmesi/silinmesi için komutlar sağlayı n
**API Entegrasyonu**: Tüm işlemler için mevcut Config API'sini kullanı n
**Tutarlı CLI Modeli**: Kuruluş içi TrustGraph CLI kuralları na ve kalı pları na uyun
**Hata Yönetimi**: Geçersiz işlemler için açı k hata mesajları sağlayı n
**JSON Çı kı şı **: Programlı kullanı m için yapı landı rı lmı ş çı ktı desteği sağlayı n
**Belgeleme**: Kapsamlı yardı m ve kullanı m örnekleri ekleyin
## Arka Plan
TrustGraph şu anda Config API ve tüm yapı landı rmayı görüntüleyen `tg-show-config` adlı tek bir CLI komutu aracı lı ğı yla yapı landı rma yönetimini sağlar. Bu, yapı landı rmayı görüntülemek için işe yarasa da, ayrı ntı lı yönetim yetenekleri eksiktir.
Mevcut sı nı rlamalar şunlardı r:
CLI'den yapı landı rma öğelerini türe göre listelemenin bir yolu yok
Belirli yapı landı rma değerlerini almak için bir CLI komutu yok
Bireysel yapı landı rma öğelerini ayarlamak için bir CLI komutu yok
Belirli yapı landı rma öğelerini silmek için bir CLI komutu yok
Bu özellik, ayrı ntı lı yapı landı rma yönetimi sağlayan dört yeni CLI komutu ekleyerek bu boşlukları giderir. Bireysel Config API işlemlerini CLI komutları aracı lı ğı yla açı ğa çı kararak TrustGraph şunları yapabilir:
Betik tabanlı yapı landı rma yönetimini etkinleştirin
Yapı landı rma yapı sı nı türe göre incelemeye izin verin
Hedefli yapı landı rma güncellemelerini destekleyin
İnce taneli yapı landı rma kontrolü sağlayı n
## Teknik Tasarı m
### Mimari
Gelişmiş CLI yapı landı rması , aşağı daki teknik bileşenleri gerektirir:
1. **tg-list-config-items**
Belirtilen bir tür için yapı landı rma anahtarları nı listeler
Config.list(type) API yöntemini çağı rı r
Yapı landı rma anahtarları nı n listesini çı ktı olarak verir
Modül: `trustgraph.cli.list_config_items`
2. **tg-get-config-item**
Belirli yapı landı rma öğesi(ni) alı r
Config.get(keys) API yöntemini çağı rı r
Yapı landı rma değerlerini JSON formatı nda çı ktı olarak verir
Modül: `trustgraph.cli.get_config_item`
3. **tg-put-config-item**
Bir yapı landı rma öğesini ayarlar veya günceller
Config.put(values) API yöntemini çağı rı r
Tür, anahtar ve değer parametrelerini kabul eder
Modül: `trustgraph.cli.put_config_item`
4. **tg-delete-config-item**
Bir yapı landı rma öğesini siler
Config.delete(keys) API yöntemini çağı rı r
Tür ve anahtar parametrelerini kabul eder
Modül: `trustgraph.cli.delete_config_item`
### Veri Modelleri
#### ConfigKey ve ConfigValue
Bu komutlar, `trustgraph.api.types` 'dan mevcut veri yapı ları nı kullanı r:
```python
@dataclasses .dataclass
class ConfigKey:
type : str
key : str
@dataclasses .dataclass
class ConfigValue:
type : str
key : str
value : str
```
Bu yaklaşı m şunları sağlar:
CLI ve API'ler arası nda tutarlı veri işleme
Tür güvenli yapı landı rma işlemleri
Yapı landı rı lmı ş girdi/çı ktı formatları
Mevcut Config API ile entegrasyon
### CLI Komut Özellikleri
#### tg-list-config-items
```bash
tg-list-config-items --type < config-type > [--format text|json] [--api-url < url > ]
```
**Amaç**: Belirli bir tür için tüm yapı landı rma anahtarları nı listele.
**API Çağrı sı **: `Config.list(type)`
**Çı ktı **:
`text` (varsayı lan): Yeni satı rlarla ayrı lmı ş yapı landı rma anahtarları .
`json` : Yapı landı rma anahtarları nı n JSON dizisi.
#### tg-get-config-item
```bash
tg-get-config-item --type < type > --key < key > [--format text|json] [--api-url < url > ]
```
**Amaç**: Belirli bir yapı landı rma öğesini almak.
**API Çağrı sı **: `Config.get([ConfigKey(type, key)])`
**Çı ktı **:
`text` (varsayı lan): Ham metin değeri.
`json` : JSON olarak kodlanmı ş metin değeri.
#### tg-put-config-item
```bash
tg-put-config-item --type < type > --key < key > --value < value > [--api-url < url > ]
tg-put-config-item --type < type > --key < key > --stdin [--api-url < url > ]
```
**Amaç**: Yapı landı rma öğesini ayarlayı n veya güncelleyin.
**API Çağrı sı **: `Config.put([ConfigValue(type, key, value)])`
**Giriş Seçenekleri**:
`--value` : Değer, doğrudan komut satı rı ndan sağlanı r.
`--stdin` : Değer, standart girişten okunur.
**Çı ktı **: Başarı onayı .
#### tg-delete-config-item
```bash
tg-delete-config-item --type < type > --key < key > [--api-url < url > ]
```
**Amaç**: Yapı landı rma öğesini silme
**API Çağrı sı **: `Config.delete([ConfigKey(type, key)])`
**Çı ktı **: Başarı onayı
### Uygulama Detayları
Tüm komutlar, mevcut TrustGraph CLI kalı bı nı izler:
Komut satı rı argüman ayrı ştı rması için `argparse` kullanı n
Arka uç iletişimi için `trustgraph.api.Api` 'i içe aktarı n ve kullanı n
Mevcut CLI komutları ndaki aynı hata işleme kalı pları nı izleyin
API uç noktası yapı landı rması için standart `--api-url` parametresini destekleyin
Açı klayı cı yardı m metni ve kullanı m örnekleri sağlayı n
#### Çı ktı Biçimi İşleme
**Metin Biçimi (Varsayı lan)**:
`tg-list-config-items` : Her satı rda bir anahtar, düz metin
`tg-get-config-item` : Ham dize değeri, tı rnak veya kodlama yok
**JSON Biçimi**:
`tg-list-config-items` : `["key1", "key2", "key3"]` dize dizisi
`tg-get-config-item` : JSON ile kodlanmı ş dize değeri `"actual string value"`
#### Giriş İşleme
**tg-put-config-item**, iki karşı lı klı olarak münhası r giriş yöntemini destekler:
`--value <string>` : Doğrudan komut satı rı dize değeri
`--stdin` : Tüm girdiyi yapı landı rma değeri olarak standart girdiden okuyun
stdin içeriği ham metin olarak okunur (satı r başları , boşluklar vb. korunur)
Dosyalardan, komutlardan veya etkileşimli girdiden boru hattı desteği
## Güvenlik Hususları
**Giriş Doğrulama**: Tüm komut satı rı parametreleri, API çağrı ları yapı lmadan önce doğrulanmalı dı r.
**API Kimlik Doğrulama**: Komutlar, mevcut API kimlik doğrulama mekanizmaları nı kullanı r.
**Yapı landı rma Erişimi**: Komutlar, mevcut yapı landı rma erişim kontrollerine saygı gösterir.
**Hata Bilgisi**: Hata mesajları , hassas yapı landı rma ayrı ntı ları nı ifşa etmemelidir.
## Performans Hususları
**Tek Öğeli İşlemler**: Komutlar, toplu işlem yükünü önlemek için tek tek öğeler için tasarlanmı ştı r.
**API Verimliliği**: Doğrudan API çağrı ları , işleme katmanları nı en aza indirir.
**Ağ Gecikmesi**: Her komut, tek bir API çağrı sı yapar ve bu da ağ iletişimini en aza indirir.
**Bellek Kullanı mı **: Tek öğeli işlemler için minimum bellek kullanı mı .
## Test Stratejisi
**Birim Testleri**: Her CLI komut modülünü bağı msı z olarak test edin.
**Entegrasyon Testleri**: CLI komutları nı canlı Config API'ye karşı test edin.
**Hata Yönetimi Testleri**: Geçersiz girişler için uygun hata yönetimini doğrulayı n.
**API Uyumluluğu**: Komutları n mevcut Config API sürümleriyle çalı ştı ğı ndan emin olun.
## Geçiş Planı
Geçiş gerekli değil - bunlar, mevcut işlevselliği tamamlayan yeni CLI komutları dı r:
Mevcut `tg-show-config` komutu değişmeden kalı r.
Yeni komutlar kademeli olarak eklenebilir.
Mevcut yapı landı rma iş akı şları nda herhangi bir değişiklik yapı lmaz.
## Paketleme ve Dağı tı m
Bu komutlar, mevcut `trustgraph-cli` paketine eklenecektir:
**Paket Konumu**: `trustgraph-cli/`
**Modül Dosyaları **:
`trustgraph-cli/trustgraph/cli/list_config_items.py`
`trustgraph-cli/trustgraph/cli/get_config_item.py`
`trustgraph-cli/trustgraph/cli/put_config_item.py`
`trustgraph-cli/trustgraph/cli/delete_config_item.py`
**Giriş Noktaları **: `trustgraph-cli/pyproject.toml` 'a `[project.scripts]` bölümüne eklendi:
```toml
tg-list-config-items = "trustgraph.cli.list_config_items:main"
tg-get-config-item = "trustgraph.cli.get_config_item:main"
tg-put-config-item = "trustgraph.cli.put_config_item:main"
tg-delete-config-item = "trustgraph.cli.delete_config_item:main"
```
## Uygulama Görevleri
1. **CLI Modüllerini Oluşturma** : `trustgraph-cli/trustgraph/cli/` içinde dört CLI komut modülünü uygulayı n.
2. **pyproject.toml'yi Güncelleme** : `trustgraph-cli/pyproject.toml` 'a yeni komut giriş noktaları ekleyin.
3. **Belgeleme** : `docs/cli/` içindeki her komut için CLI belgelerini oluşturun.
4. **Test** : Kapsamlı test kapsamı uygulayı n.
5. **Entegrasyon** : Komutları n mevcut TrustGraph altyapı sı yla çalı ştı ğı ndan emin olun.
6. **Paket Oluşturma** : Komutları n `pip install trustgraph-cli` ile düzgün bir şekilde yüklendiğini doğrulayı n.
## Kullanı m Örnekleri
#### Yapı landı rma öğelerini listeleme
```bash
# List prompt keys (text format)
tg-list-config-items --type prompt
template-1
template-2
system-prompt
# List prompt keys (JSON format)
tg-list-config-items --type prompt --format json
["template-1", "template-2", "system-prompt"]
```
#### Yapı landı rma öğesini al
```bash
# Get prompt value (text format)
tg-get-config-item --type prompt --key template-1
You are a helpful assistant. Please respond to: {query}
# Get prompt value (JSON format)
tg-get-config-item --type prompt --key template-1 --format json
"You are a helpful assistant. Please respond to: {query}"
```
#### Yapı landı rma öğesini ayarlayı n
```bash
# Set from command line
tg-put-config-item --type prompt --key new-template --value "Custom prompt: {input}"
# Set from file via pipe
cat ./prompt-template.txt | tg-put-config-item --type prompt --key complex-template --stdin
# Set from file via redirect
tg-put-config-item --type prompt --key complex-template --stdin < . / prompt-template . txt
# Set from command output
echo "Generated template: {query}" | tg-put-config-item --type prompt --key auto-template --stdin
```
#### Yapı landı rma öğesini sil
```bash
tg-delete-config-item --type prompt --key old-template
```
## Açı k Sorular
Komutlar, tek öğelerin yanı sı ra toplu işlemleri (çoklu anahtarlar) desteklemeli mi?
Başarı onayları için hangi çı ktı formatı kullanı lmalı dı r?
Konfigürasyon türleri kullanı cı lar tarafı ndan nası l belgelenmeli/keşfedilmelidir?
## Referanslar
Mevcut Konfigürasyon API'si: `trustgraph/api/config.py`
CLI kalı pları : `trustgraph-cli/trustgraph/cli/show_config.py`
2026-04-10 23:20:41 -04:00
Veri türleri: `trustgraph/api/types.py`