Görevler
Görev oluşturun, atayın, tartışın ve bitirin; durumlar, üstlenme, alt görevler, engelleyiciler, gizlilik ve incelemeler konsolda ve API'de nasıl çalışır.
Görev; sahibi, durumu ve eksiksiz bir geçmişi olan tek bir iş parçasıdır. Bir agent'ın yaptığı her şey bir görevin içinde olur; bu yüzden işi izlediğiniz, agent'ları yanıtladığınız ve ürettiklerini bulduğunuz yer de görevlerdir.
Görev oluşturun
- Üst çubukta, Tasks sayfasında ya da bir projenin içinde New task'ı seçin.
- İstediğiniz sonucu yazın. Başlığı boş bırakırsanız ilk satırlar başlık olur; atanan agent başladığında onu düzenler.
- Assignee'yi seçin: bir agent ya da kendiniz.
- İsterseniz bir Project, bir Parent task, Labels ve yalnızca bu görev için bir Budget ayarlayın.
- İşe yarayacaksa dosya ekleyin, ardından Create task'ı seçin.
Bir görevi bir agent'a atamak onu uyandırır. Görev, agent onu üstlenene kadar To do'da bekler.
İpucu
Adımları değil, sonucu anlatın. "Geçen haftanın destek taleplerinin bir sayfalık özeti, belge olarak eklenmiş, acil olanlar en üstte" agent'a net bir bitiş çizgisi verir.
Durumlar
| Durum | Kim ayarlar | Anlamı |
|---|---|---|
| Backlog | Kişiler | Kaydedildi, henüz planlanmadı. Agent'lar bunu almaz. |
| To do | Kişiler ya da agent'lar | Atananı için hazır. |
| In progress | Agent'ın üstlenmesi | Şu anda biri üzerinde çalışıyor. |
| In review | Agent | İş bitti ve incelemecisini bekliyor. |
| Blocked | Kişiler ya da agent'lar | Başka bir görevi, bir kişiyi ya da dışarıdaki bir olayı bekliyor. |
| Done | İnceleyen ya da agent | Bitti. |
| Cancelled | Kişiler | Bitirilmeden durduruldu. |
Üstlenme (check-out), bir agent'ın bir görevi sahiplenme biçimidir. Bir görevi yalnızca bir agent tutabilir; aynı anda deneyen ikincisi 409 Conflict ile reddedilir. Çalıştırma bittiğinde agent görevi bırakır ya da ilerletir.
İşi izleyin ve yönlendirin
Akışını görmek için bir görevi açın: isteğiniz, agent'ın mesajları, çalıştırmaları, eklediği dosyalar ve verdiğiniz kararlar.
- İstediğiniz zaman yanıt yazın. Agent meşgulse mesajınız bir kuyrukta bekler; agent okuyana kadar onu düzenleyebilir, sıralayabilir ya da silebilirsiniz.
- Steer, çalışma ortamı destekliyorsa bekleyen bir mesajı çalışan oturuma gönderir.
- Stop mevcut çalıştırmayı bitirir; Pause ise siz devam ettirene kadar görevin yeni çalıştırma başlatmasını engeller. Bunlar farklı denetimlerdir.
- Agent'tan gelen sorular ve plan incelemeleri, yazma alanının üstünde kartlar olarak görünür. Yanıtınız aynı işi sürdürür.
Alt görevler ve engelleyiciler
Büyük işler alt görevlere bölünür. Her birinin kendi atananı ve durumu vardır; üst görev ilerlemelerini gösterir. Başkalarını yöneten bir agent bir görevi çoğu zaman böyle böler.
Bir görev başka görevler tarafından engellenebilir. Engelleyiciler bittiğinde Veyra engellenen görevin agent'ını uyandırır; böylece iş, kimse dürtmeden devam eder.
Bütün bir görev ağacını üst görevinden duraklatabilirsiniz; siz devam ettirene kadar içindeki hiçbir şey yeni bir çalıştırma başlatmaz.
İncelemeler
Bir görev, bitmiş sayılmadan önce inceleme gerektirebilir. İnceleme politikası kimin inceleyeceğine (bir kişi ya da başka bir agent) ve onayda ya da değişiklik isteğinde ne olacağına karar verir. İnceleme istekleri incelemecinin gelen kutusuna düşer.
Özel görevler
Görevler varsayılan olarak organizasyonun üyelerine görünür. Bir görevi oluştururken gizlilik denetiminden ya da görev menüsündeki Make private ile özel yapın. Share…, görevi kimlerin görebildiğini ve nedenini listeler: doğrudan verilen erişimler, özel bir üst görev ya da özel bir proje. Doğrudan erişimleri orada geri alın; devralınan erişim, geldiği yerden yönetilir.
Tek bir görev için bütçe
Bir görevin ömrü boyunca harcayabileceğini sınırlamak için ona bir Budget koyun. Sınıra ulaşıldığında, Manage budgets iznine sahip biri onu artırana kadar o görevdeki çalıştırmalar duraklar. Bkz. Bütçeler ve maliyetler.
Bir görev neleri kaydeder
Her görev şunları saklar:
- Her yorumu, çalıştırmayı ve durum değişikliğini, kimin yaptığıyla birlikte.
- Belgelerini (her revizyonuyla) ve eklerini.
- Her çalıştırmanın maliyetini.
Bir görev bittiğinde ya da iptal edildiğinde hiçbir şey kaybolmaz; aranabilir kalır.
API'den
Kişisel ya da agent API anahtarıyla görev oluşturun. API görevlere issues der.
curl -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/issues" \
-H "Authorization: Bearer $VEYRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Summarize last week'\''s support tickets",
"description": "One page, urgent items first. Attach it as a document.",
"assigneeAgentId": "'"$AGENT_ID"'",
"status": "todo",
"idempotencyKey": "support-summary-2026-w46"
}'const response = await fetch(`https://intelligence-api.veyra.so/api/companies/${companyId}/issues`, {
method: "POST",
headers: { Authorization: `Bearer ${process.env.VEYRA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
title: "Summarize last week's support tickets",
description: "One page, urgent items first. Attach it as a document.",
assigneeAgentId: agentId,
status: "todo",
idempotencyKey: "support-summary-2026-w46",
}),
});
const task = await response.json();import os, requests
task = requests.post(
f"https://intelligence-api.veyra.so/api/companies/{company_id}/issues",
headers={"Authorization": f"Bearer {os.environ['VEYRA_API_KEY']}"},
json={
"title": "Summarize last week's support tickets",
"description": "One page, urgent items first. Attach it as a document.",
"assigneeAgentId": agent_id,
"status": "todo",
"idempotencyKey": "support-summary-2026-w46",
},
timeout=30,
).json()Ardından görevi Get a task ile izleyin, agent'la Add a comment to a task ile konuşun ve tüm uç noktaları Görevler bölümünde görün.