Veyra Hands nedir

Veyra'nın agent çalıştırıcısı: ne yaptığı, sürdüğü harness'lar, nerede çalıştığı ve Veyra Intelligence ile nasıl birlikte çalıştığı.

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

Veyra Hands, bir agent'ın işini yapan çalıştırıcıdır. Claude ya da Codex gibi bir kodlama agent'ı harness'ını başlatır, agent çalışırken oturumu açık tutar, bir çalıştırma kesintilere dayansın diye kontrol noktaları kaydeder ve her araç çağrısını agent'ı yöneten kontrol paneline geri gönderir. Bu kontrol paneli Veyra Intelligence'tır: kimin neyle uğraşacağına o karar verir, çalıştırmayı Hands yürütür. Hands, Intelligence'ın içine yerleşiktir: Intelligence'ın agent'ları çalıştırmak için kullandığı motordur; ayrıca indirilecek ya da kurulacak bir şey yoktur.

Agent'lar, harness'lar ve çalıştırıcılar

  • Agent, Intelligence'ta organizasyonunuzun bir üyesidir; bir rolü, bir yöneticisi, bir bütçesi ve izinleri vardır.
  • Harness, okuyan, düşünen ve düzenleyen programdır: Claude, Codex, OpenCode ve diğerleri. Intelligence'ta agent'ın çalışma ortamıdır.
  • Çalıştırıcı harness'ı başlatır, onu kontrol paneline bağlar ve çalıştırma bitene kadar denetler. Veyra Hands, Veyra'nın çalıştırıcısıdır.

Hands harness'ın yerini almaz ve nasıl düşündüğünü değiştirmez. Her harness kendi araçlarını ve alışkanlıklarını korur; Hands bunların etrafına oturumu, kontrol noktalarını ve denetlenen araçları ekler.

Hands ne yapar

Gerçek harness'ı çalıştırır

Hands harness programını kendisi başlatır ve onun kendi protokolüyle konuşur: Codex ile app server üzerinden, OpenCode ile kendi sunucusu üzerinden, Claude ve Grok ile Agent Client Protocol üzerinden. Harness, bağladığınız model hesabıyla oturum açar ve seçtiğiniz modeli kullanır. Hands bu modeli değiştirmeden iletir; sağlayıcı modeli reddederse çalıştırma başka bir modele geçmek yerine açık bir hatayla durur.

Oturumları kesintilere rağmen korur

Hands çalıştırma ilerledikçe kontrol noktaları kaydeder. Hands ile Intelligence arasındaki bağlantı koparsa çalıştırma yeniden bağlanır ve kaldığı yerden devam eder. Harness kendi konuşmasını sürdürebiliyorsa Hands onu sürdürür; sürdüremiyorsa görevin geçmişinden kısa bir devir notuyla yeni bir konuşma başlatır, böylece agent sıfırdan başlamaz.

Çalıştırmayı yönlendirmenize izin verir

Agent çalışırken göreve yazdığınız yorum çalışan tura ulaşır ve agent onu bir sonraki adımında okur. Model bir yorumu okumadan çalıştırma yeniden başlarsa Hands yorumu yeniden iletir. Bir çalıştırmayı istediğiniz an durdurabilirsiniz. Agent size bir soru sorduğunda soru görevde ve Inbox'ınızda görünür.

Araç çağrılarını kontrol panelinden geçirir

Agent'ın Intelligence'tan aldığı araçlar (görevleri okumak ve güncellemek, işini bitirmek ya da engellendiğini bildirmek ve ona atanmış bağlantılar) harness'a Hands üzerinden ulaşır. Her çağrı Intelligence'a geri döner; Intelligence çağrı çalışmadan önce onu agent'ın izinlerine göre kontrol eder. Bu araçların arkasındaki kimlik bilgileri yalnızca o çalıştırma için geçerlidir.

Başlattığı şeyi doğrular

Harness programları sabitlenmiş derlemelerden gelir, hash ile kontrol edilir ve her Hands sürümüyle paketlenir. Bir makinede harness başlamadan önce Hands kurulu paketi sürümüyle karşılaştırır. Eksik ya da uyuşmayan bir paket, başka bir şey çalıştırmak yerine açık bir hatayla sonuçlanır.

Yaptığı her şeyi canlı aktarır

Her mesaj, araç çağrısı, dosya değişikliği ve sonuç türü belli bir olaydır. Intelligence bunları görevde canlı gösterir ve okunabilir bir özetin altında çalıştırmanın dökümü olarak saklar.

Çalıştırdığı harness'lar

Harness Hands onunla nasıl konuşur Notlar
Claude Agent Client Protocol Bir Claude aboneliği ya da Anthropic API anahtarıyla oturum açar.
Codex Codex app server Bir ChatGPT hesabı ya da OpenAI API anahtarıyla oturum açar.
OpenCode OpenCode sunucusu Linux Arm'da yok.
Grok Agent Client Protocol Linux x64 ve Apple silicon'lu macOS.
Cursor Cloud Cursor'ın barındırdığı agent'lar Deneysel. Cursor agent'ı kendi bulut makinesinde çalıştırır.

Nerede çalışır

Hands agent'ın ortamında çalışır: Intelligence'ı çalıştıran makinede, eklediğiniz bir SSH sunucusunda ya da bir sandbox'ta. Desteklenenler:

  • x64 ve Arm üzerinde, glibc 2.39 ya da sonrası olan Linux;
  • Apple silicon ve Intel üzerinde macOS.

Intelligence bir agent için Hands'i seçmeden önce ortamı kontrol eder. Hands'in bir harness'ı çalıştıramadığı yerde agent önceki çalıştırıcıda kalır ve agent'ın ayarları nedenini söyler.

Hands ve Intelligence

Intelligence ile Hands işi şöyle bölüşür:

Intelligence Hands
Agent'ı bir görev, yorum ya da rutin için uyandırır Harness oturumunu başlatır ya da sürdürür
Agent'ın rolünü, izinlerini ve bütçesini tutar Turu çalıştırır ve olanları canlı aktarır
Yönetilen aksiyonları onaya sunar ve her değişikliği kaydeder Her araç çağrısını karar için geri gönderir
Özeti, dökümü ve maliyeti görevde tutar Çalıştırma devam edebilsin diye kontrol noktaları kaydeder

Hands üzerindeki her çalıştırma sıradan bir Intelligence çalıştırmasıdır: bütçelerden düşer, Costs'ta görünür ve dökümünü görevde tutar.

Hands, Intelligence ile birlikte gelir ve onunla güncellenir: her Intelligence sürümü, birlikte test edildiği Hands sürümüyle yayımlanır; böylece ikisi hiçbir zaman birbirinden ayrışmaz.

Sonraki adımlar

HandsKavramlar