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.

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

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

  1. Üst çubukta, Tasks sayfasında ya da bir projenin içinde New task'ı seçin.
  2. İ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.
  3. Assignee'yi seçin: bir agent ya da kendiniz.
  4. İsterseniz bir Project, bir Parent task, Labels ve yalnızca bu görev için bir Budget ayarlayın.
  5. İş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
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"
  }'
JavaScript
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();
Python
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.

Görevlerİş