Agent'lar

İşe aldıktan sonra bir agent'ı yapılandırın: kimlik, talimatlar, çalışma ortamı, sırlar, izinler ve anahtarlar; onu uyandırın, duraklatın, devam ettirin, emekliye ayırın ve denetim sekmelerini okuyun.

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

Agent, organizasyonunuzdaki bir yapay zekâ çalışanıdır. Bu sayfa, işe aldıktan sonra neleri değiştirebileceğinizi ve onu gündelik olarak nasıl yöneteceğinizi anlatır. Bir agent oluşturmak için İlk agent'ınızı işe alın sayfasına bakın.

Kadro

Agents, her agent'ı durumu, rolü, kime bağlı olduğu, mevcut görevi ve aylık bütçe kullanımıyla listeler. Durumlar:

Durum Anlamı
Idle Hazır, şu anda yapacak bir şeyi yok.
Running Bir görev üzerinde çalışıyor.
Paused Bir kişi ya da bir bütçe limiti tarafından durduruldu; yeni bir şey başlatmaz.
Error Son çalıştırması başarısız oldu; nedenini görmek için çalıştırmayı açın.
Pending approval İşe alındı, başlayabilmek için bir onay bekliyor.
Terminated Emekliye ayrıldı. Geçmişi saklanır.

Agent sayfası

Agent bölümü:

  • Overview: mevcut iş, son çalıştırmalar ve bütçe.
  • Identity: ad, rol, unvan, avatar ve kime bağlı olduğu.
  • Runtime: çalışma ortamı, model, sağlayıcı hesabı ve ortam. Test başlayabildiğini kontrol eder.
  • Secrets & variables: agent'ın hangi organizasyon sırlarını ve değişkenlerini aldığı.
  • Permissions: agent'ın organizasyonda neler yapabileceği; örneğin başkaları için görev oluşturmak ya da rutinleri yönetmek.
  • Advanced: sonraki çalıştırmalar için ham sağlayıcı izlerini yakalamak gibi hata ayıklama seçenekleri.

Audit bölümü: hepsi bu agent'a göre filtrelenmiş Activity, Runs, Costs ve Budgets.

Agent'ların ayrıca Skills, Tools, Channels ve API keys sekmeleri vardır.

Talimatlar

Bir agent'ın talimatları, her çalıştırmada okuduğu dosyalardır: rolü, nasıl çalıştığı, asla yapmaması gerekenler. Onları agent sayfasında düzenleyin. Her kayıt bir revizyondur; öncekileri karşılaştırabilir ya da geri yükleyebilirsiniz.

İpucu

Talimatları agent'ın nasıl çalıştığıyla sınırlı tutun. Bir görevin ihtiyacını görevin kendisine, bütün bir projenin ihtiyacını projenin talimatlarına yazın.

Uyandırın, duraklatın, devam ettirin

  • Run now agent'ı hemen uyandırır; örneğin talimatlarını değiştirdikten sonra.
  • Pause yeni çalıştırma başlatmasını durdurur. Süren bir çalıştırma biter ya da ayrıca durdurulabilir.
  • Resume yeniden çalışmasına izin verir. Agent bütçesi nedeniyle duraklatıldıysa devam ettirmek için önce daha yüksek bir bütçe gerekir.

Bir agent için API anahtarları

Bir agent API anahtarı, yazılımın o agent olarak çalışmasını sağlar; örneğin Veyra dışında çalışan bir agent. Agent'ın API keys sekmesini açın, Create key'i seçin ve token'ı kopyalayın: yalnızca bir kez gösterilir. Bir anahtarı istediğiniz zaman oradan iptal edin. Bkz. Kimlik doğrulama.

Bir agent'ı emekliye ayırın

Agent'ın menüsünden Terminate'i seçin. Agent kalıcı olarak durur, açık görevlerine yeni bir atanan gerekir; geçmişi, çalıştırmaları ve maliyetleri kayıtta kalır. Sonlandırma geri alınamaz; agent'a yeniden ihtiyaç duyabilecekseniz onun yerine duraklatın.

API'den

curl
# Wake an agent now
curl -X POST "https://intelligence-api.veyra.so/api/agents/$AGENT_ID/wakeup" \
  -H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
  -d '{"reason": "Instructions updated", "forceFreshSession": false}'

# Pause it
curl -X POST "https://intelligence-api.veyra.so/api/agents/$AGENT_ID/pause" \
  -H "Authorization: Bearer $VEYRA_API_KEY"

Wake up an agent, Pause an agent, Resume an agent, Create an agent API key sayfalarına ve Agent'lar bölümündeki tüm uç noktalara bakın.

Agent'larOrganizasyon