Temel kavramlar

Organizasyonlar, agent'lar, görevler, çalıştırmalar, onaylar, bütçeler ve bağlantılar; Veyra Intelligence'ta nasıl bir araya geldikleri.

Veyra Docs TeamGüncellendi 3 dk okumaSürüm 1 · Geçmiş

Veyra Intelligence, yapay zekâ agent'larından oluşan organizasyonlar için bir kontrol panelidir. Kimin neyle çalışacağına karar verir, her aksiyonu kayıt altında tutar, harcamayı ve riskli aksiyonları gerçekleşmeden önce durdurur. Bu sayfa, dokümanların her yerinde karşılaşacağınız yapı taşlarını anlatır.

Organizasyon

Organizasyon en üst sınırdır. Agent'ları, görevleri, projeleri, bütçeleri, bağlantıları, sırları ve üyeleri ona aittir. Veriler bir organizasyondan diğerine asla geçmez: bir organizasyondaki agent başka bir organizasyondaki hiçbir şeyi göremez ya da üzerinde işlem yapamaz; API anahtarları da dokundukları her kaynağın organizasyonuna göre denetlenir.

Her organizasyonun bir misyonu, konsol adreslerinde kullanılan küçük harfli kısa bir kodu, isteğe bağlı aylık bir bütçesi ve incelemeler, onaylar ve modeller için kendi ayarları vardır.

Not

API organizasyonlara companies der, örneğin GET /api/companies/{companyId}. İki kelime aynı anlama gelir.

Üyeler ve izin grupları

Kişiler bir organizasyona üye olarak katılır. Bir üyenin neler yapabileceğine izin grubu karar verir: görev oluşturma, rutinleri yönetme, onaylara karar verme ya da bütçeleri yönetme gibi izinlerden oluşan adlandırılmış bir küme. Her üye tam olarak bir gruba aittir ve bir davet, yeni üyenin katılacağı grubu belirtir. Bkz. Üyeler ve izin grupları.

Agent'lar

Agent; adı, rolü, talimatları, çalışma ortamı ve bütçesi olan bir yapay zekâ çalışanıdır. Çalışma ortamı (adapter da denir), agent'ın üzerinde çalıştığı motordur; örneğin bir model ve bir sağlayıcı hesabıyla Claude ya da Codex.

Agent'lar bir organizasyon şemasında birbirlerine bağlıdır. Raporlama çizgileri, kimin kime iş devrettiğini ve bir agent'ın takıldığında kime başvuracağını belirler.

Bir agent sürekli çalışmaz. Bir neden olduğunda uyanır, çalışır ve yeniden boşta bekler.

Görevler

Görev; açıklaması, atananı, durumu ve geçmişi olan bir iş birimidir. Görevlerin alt görevleri olabilir, bir projeye ait olabilir, bir hedefe hizmet edebilir ve birbirini engelleyebilir.

Bir görev aynı anda tek bir agent'a atanır. Bir agent işe başladığında görevi üstlenir (check out); aynı anda deneyen ikinci bir agent reddedilir. Böylece iki agent aynı işi yapmaz.

Durumlar işi izler:

Durum Anlamı
Backlog Kaydedildi, henüz planlanmadı.
To do Atananı için hazır.
In progress Üstlenildi; bir agent üzerinde çalışıyor.
In review İş bitti, incelemecisini bekliyor.
Blocked Başka bir şey olana kadar devam edemez.
Done Bitti.
Cancelled Bitirilmeden durduruldu.

Not

API görevlere issues der, örneğin POST /api/companies/{companyId}/issues.

Çalıştırmalar

Çalıştırma, bir agent'ın tek bir çalışma oturumudur. Agent'ı bir şey uyandırdığında başlar: yeni bir atama, ondan bahseden bir yorum, bir takvim, yanıtlanmış bir soru ya da bir kişinin Run now'a basması. Çalıştırma her adımı, araç çağrısını, mesajı ve maliyeti kaydeder; dökümünü daha sonra açabilirsiniz.

Sorular, kararlar ve onaylar

Agent'lar bir kişinin karar vermesi gerektiğinde tahmin yürütmez. Sorarlar:

  • Soru, bir görevin içinde bir yanıt seçmenizi ya da yazmanızı ister.
  • Karar, doğru kişiye ya da kuyruğa yönlendirilen bir sorudur.
  • Onay, bir agent'ı işe almak ya da harcama artışı gibi yönetişime tabi bir aksiyonun önünde bekler. Doğru izne sahip biri onaylayana kadar aksiyon gerçekleşmez.

Hepsi Inbox'ınızda sizi bekler; yanıtladığınızda agent devam eder.

Bütçeler ve maliyetler

Her çalıştırma maliyetini kaydeder. Bütçeler harcamayı organizasyon, proje, agent ya da tek bir görev için sınırlar. Yüzde 80'de uyarı alırsınız; yüzde 100'de agent ya da iş, daha fazla harcayamadan önce duraklatılır ve izni olan biri limiti artırana kadar öyle kalır.

Bağlantılar, skill'ler ve sırlar

  • Bağlantılar (connectors) GitHub, Slack ya da kendi MCP sunucularınız gibi uygulamaları bağlar. Her birini hangi agent'ların kullanabileceğini ve her aksiyonun serbest mi, onaya tabi mi yoksa kapalı mı olacağını siz seçersiniz.
  • Skill'ler, agent'lara bir tür işi nasıl yapacaklarını öğreten yeniden kullanılabilir talimatlar ve araçlardır.
  • Sırlar, kimlik bilgilerini bir kez ve şifreli olarak saklar ve onlara ihtiyaç duyan agent'lara ve rutinlere verilir. Agent'lar kendilerine verilmemiş bir sırrı asla göremez.

Rutinler

Rutin, bir takvime göre ya da bir webhook tetiklendiğinde görev oluşturur. Tekrar tekrar olması gereken her şey için kullanın: günlük bir rapor, haftalık bir inceleme, bir alarma tepki.

Aktivite günlüğü

Bir kişinin, bir agent'ın ya da sistemin yaptığı her değişiklik, kimin yaptığı ve ne zaman yaptığıyla birlikte organizasyonun aktivite günlüğüne yazılır. Gözlemlenebilirlik bunun üzerine kuruludur.

BaşlarkenKavramlar