Arduino App Lab 0.10 Agentic Mode Nasıl Kullanılır? İlk Proje Akışı

Arduino App Lab 0.10 Agentic Mode'u, bir proje fikrini adımlara bölmek ve ilk taslağı çıkarmak için bir yardımcı olarak kullanabilirsin. Kuruluma ya da hesap gereksinimlerine girmeden önce şunu bil: Pin bağlantısı, kütüphane uyumu, besleme ve gerçek donanım davranışı yapay zekânın değil senin sorumluluğundadır ve her biri ayrı ayrı test edilmelidir. Bu yazı, ilk LED ve ışık sensörü projesi üzerinden öneriyi çalışan bir devreye çevirmenin güvenli akışını gösteriyor.

Agentic Mode nedir ve App Lab içinde ne işe yarar?

Agentic Mode, Arduino App Lab içinde yapay zekâ desteğiyle çalışma biçimidir. Ona "ışık azalınca LED yansın" gibi bir hedef verirsin. Hedefi küçük adımlara bölmesini, bir kod taslağı önermesini ve bu taslağın ne yaptığını açıklamasını isteyebilirsin. Boş ekranla başlamak yerine tartışabileceğin, düzeltebileceğin bir başlangıç noktan olur.

Özelliğin tam olarak nasıl açıldığı ve arayüzde nerede durduğu sürümler arasında değişebilir. Hangi kartların desteklendiği, işletim sistemi, hesap ya da internet gereksinimi gibi ayrıntılar da aynı şekilde değişebilir. Bu bilgiler için kesin cümle kurmak yerine seni kaynağa yönlendiriyorum: Kullandığın sürümün resmî duyurusuna ve Arduino'nun belgelerine bak, desteklenen kartları ve gereksinimleri oradan kontrol et.

Agentic Mode'un yapmadıkları

Sınırlarını baştan bilmek, onu doğru kullanmanın yarısıdır:

• Masandaki devreyi görmez; LED'i hangi pine, sensörü hangi girişe bağladığını bilmez.
• Bağlantını doğrulamaz. Tel gevşekse ya da LED ters takılıysa bunu fark edemez.
• Önerdiği kodun donanımda çalışacağına dair bir güvence vermez. Taslak, senin kurduğun düzenek için değil, senin anlattığın düzenek için yazılır.

Bu yüzden onu projeyi senin yerine kuran bir araç olarak değil, taslak ve fikir üreten bir çalışma arkadaşı olarak düşün. Karar, ölçüm ve düzeltme sende kalır.

Yapay zekâ önerisi neden doğrudan çalıştırılmamalı?

Yapay zekâ modelleri, akıl yürütmeyi taklit eden metin üretir. Devreni görmezler, kartının gerçek durumunu bilmezler; verdiğin açıklamaya göre makul görünen bir yanıt üretirler. Makul görünen bir kod ise donanımda sorun çıkarabilir. Arduino projelerinde sık karşılaşılan dört riski bilmek, öneriyi çalıştırmadan önce neye bakacağını netleştirir.

Yanlış pin eşlemesi. Öneri kodundaki pin numarası, senin bağladığın pinle aynı olmayabilir. Kart üzerindeki etiketle yazılımdaki numara da her zaman aynı görünmez; bu yüzden kodu çalıştırmadan önce pin tanımını fiziksel bağlantınla tek tek karşılaştır.

Akım sınırlayıcı direnç eksikliği ya da yanlış değer. LED'e seri bir direnç bağlanmadıysa LED ya da pin zarar görebilir. Direnç değeri ise LED'in ve besleme geriliminin özelliklerine bağlıdır. Önerideki değeri olduğu gibi kabul etme; hesabını ve LED'in teknik bilgisini kontrol et.

Kartın lojik gerilimine uymayan bağlantı. Kartlar farklı lojik gerilim seviyeleriyle çalışabilir; sensör ya da modül bu seviyeye uymuyorsa ölçümler bozulur, en kötü durumda bileşen zarar görür. Kullandığın kartın lojik gerilim seviyesini ve pin başına akım sınırını kartın resmî dokümanından oku, bağladığın her bileşenin değerlerini bununla karşılaştır.

Kütüphane ve çekirdek uyumsuzluğu. Önerilen kütüphane kullandığın kartı ya da kart paketini desteklemeyebilir. Derleme hatası bunu çoğu zaman gösterir, ama kod derlendi diye doğru çalışacağı anlamına gelmez; kütüphanenin belgesinde kart desteğine bak.

Yapay zekâ araçlarını doğru kullanmak ezberlenecek bir tarif değil, düşünmeye dayalı bir beceridir: Çıktıyı sorgularsın, nedenini anlarsın, kendi ölçümünle sınarsın. Berk Akademi'nin birebir Python ve Java programlarında Claude, Codex ve Cursor gibi araçların bu bakışla doğru kullanımı işlenir. Aynı alışkanlık, App Lab'de gelen her öneriye de uygulayabileceğin bir yaklaşımdır.

İlk proje akışı: LED ve ışık sensörü için istek, taslak kod ve beklenen çıktı

Agentic Mode'dan iyi sonuç almanın ilk koşulu belirsiz olmayan bir istek yazmaktır. Aşağıdaki örnek istek, bir LED ile bir ışık sensörünü birlikte çalıştıran küçük bir proje içindir:

Kartım: üzerinde yazan tam model adı. Devrede bir LED (220 ohm dirençle, pin 8) ve bir LDR var. LDR, sabit bir dirençle gerilim bölücü olarak kurulu ve orta noktası A0 pinine bağlı. Ortam ışığı bir eşiğin altına düşünce LED yansın, eşiğin üstünde sönsün. Serial Monitor'e 9600 hızında "ISIK: değer | LED: ACIK" ya da "ISIK: değer | LED: KAPALI" biçiminde satır yazdır. Kodda eşik değeri tek bir sabit olsun, okuma aralığı delay ile yarım saniye olsun.

İyi bir istek dört öğe taşır: donanım (kart ve bileşenler), pinler (hangi bileşen hangi pine bağlı), davranış (hangi koşulda ne olacak) ve kısıtlar (Serial biçimi, okuma aralığı, sabitler). Bunlardan biri eksikse araç boşluğu kendi varsayımıyla doldurur.

Aşağıdaki kod, böyle bir isteğe karşılık incelenecek bir öneri örneğidir; araç çıktısı değildir. Örnek klasik Arduino sketch biçimindedir, App Lab'deki proje yapısını resmî dokümana göre uyarlaman gerekir.

const int LED_PIN = 8;
const int LDR_PIN = A0;
const int ESIK = 400;

void setup() {
  pinMode(LED_PIN, OUTPUT);
  Serial.begin(9600);
}

void loop() {
  int isik = analogRead(LDR_PIN);
  bool karanlik = isik < ESIK;

  digitalWrite(LED_PIN, karanlik ? HIGH : LOW);

  Serial.print("ISIK: ");
  Serial.print(isik);
  Serial.print(" | LED: ");
  Serial.println(karanlik ? "ACIK" : "KAPALI");

  delay(500);
}

Satır satır: ilk üç sabit pinleri ve eşiği tek yerde toplar. setup() LED pinini çıkış yapar ve Serial bağlantısını 9600 hızında açar. loop() içinde analogRead sensör gerilimini sayıya çevirir, isik < ESIK karşılaştırması karanlık olup olmadığını belirler, LED buna göre yanar ya da söner ve durum Serial'e yazılır. delay(500) okumalar arasında yarım saniye bekletir.

Serial Monitor'de şuna benzer satırlar görmeyi beklersin:

ISIK: 612 | LED: KAPALI
ISIK: 598 | LED: KAPALI
ISIK: 187 | LED: ACIK

Sayılar ortama, sensöre ve sabit dirence göre değişir. Okuma aralığı da kartın analog çözünürlüğüne bağlıdır; bu yüzden örnekteki değerleri referans alma, kendi ölçümünü kullan. Taslakta bilerek incelenecek iki nokta var: ESIK değeri deneyle ayarlanır (sensörü ışıkta ve gölgede okuyup ikisinin arasında bir değer seç) ve pin numaraları kendi devrene göre güncellenir.

Beş adımlı doğrulama akışı: öneriden çalışan devreye

Öneri ne kadar düzgün görünürse görünsün, çalışan devreye giden yol beş adımdır. Her adımın yanında bir sonrakine geçme ölçütü var:

1. İsteği oluştur. Donanım, pinler, davranış ve kısıtlar yazılıdır. Geçiş ölçütü: isteği okuyan biri devreyi eksiksiz çizebiliyorsa.
2. Öneriyi parçalara ayır. Bağlantı listesi, kod, kütüphaneler ve güç ayrı ayrı ele alınır. Geçiş ölçütü: her parça için "bu neden orada?" sorusunu yanıtlayabiliyorsan.
3. Kodu satır satır incele. Pin tanımlarına, eşiğe, delay süresine ve Serial hızına bakılır. Geçiş ölçütü: koddaki her sayının kaynağını biliyorsan.
4. Devreyi kartı beslemeden önce kontrol et. Pin eşleşmesi, direnç değerleri, ortak GND ve kartın çalışma gerilimi gözden geçirilir. Geçiş ölçütü: bağlantılar listeyle birebir örtüşüyorsa.
5. Davranışı küçük testlerle doğrula. Önce yalnız LED, sonra yalnız sensör, en son ikisi birlikte denenir. Geçiş ölçütü: her test beklenen Serial çıktısını ve LED davranışını veriyorsa.

Bu adımlar birbirinin yerine geçmez. Kodu kusursuz okumak yanlış takılmış bir kabloyu göstermez, devreyi doğru kurmak da yanlış bir eşiği düzeltmez. Hiçbiri tek başına yeterli değildir; güvenilir sonuç beşinin birlikte uygulanmasından gelir.

Serial çıktısı ve deneme günlüğü: ne denediğini nasıl kaydedersin?

Serial Monitor, Arduino'da en ucuz hata ayıklama aracıdır. Ek donanım gerektirmez, kartın o an ne gördüğünü ekrana yazar ve devreyle kod arasındaki sorunu ayırmana yardım eder. Burada kritik nokta ham değer ile yorumlanmış değeri yan yana yazdırmaktır. Ham değer sensörün gerçekte ne okuduğunu, yorumlanmış değer ise kodun bu okumadan ne sonuç çıkardığını gösterir.

Aşağıdaki kısa örnek, incelemen gereken bir öneri taslağı gibi düşünülmelidir. Pin numaraları ve eşik değeri senin devrene göre değişir.

const int LDR_PIN = A0;
const int LED_PIN = 8;
const int ESIK = 400;

void setup() {
  Serial.begin(9600);
  pinMode(LED_PIN, OUTPUT);
}

void loop() {
  int ham = analogRead(LDR_PIN);
  bool karanlik = ham < ESIK;
  digitalWrite(LED_PIN, karanlik ? HIGH : LOW);

  Serial.print("ham=");
  Serial.print(ham);
  Serial.print(" karanlik=");
  Serial.println(karanlik);
  delay(500);
}

Beklenen çıktı ham=312 karanlik=1 ya da ham=701 karanlik=0 gibi satırlardır. Sayılar bağlantına göre değişir. Sensör bölücüde hangi tarafta duruyorsa ışıkla değerin artması ya da azalması da değişebilir.

Çıktı ÿ�?� gibi anlamsız karakterlerden oluşuyorsa genellikle koddaki Serial.begin(9600) değeriyle Serial Monitor'de seçili baud hızı uyuşmuyordur. İkisini eşitlemek çoğu zaman sorunu çözer.

Tek değişiklik, tek satır günlük

Bir denemede yalnızca tek şeyi değiştir ve sonucu yaz. Aynı anda eşiği, pini ve kabloyu değiştirirsen düzelmenin ya da bozulmanın nedenini bilemezsin. Örnek bir günlük şöyle görünebilir:

Bu günlükte sorunun eşikte değil bağlantıda olduğu, ham değer yazdırılınca ortaya çıktı. Yapay zekâya geri dönerken de aynı kaydı isteğine ekleyebilirsin: hangi kodu çalıştırdığını, Serial'de ne gördüğünü ve hangi denemeleri yaptığını yaz. Bu, "çalışmıyor" demekten çok daha yönlendirici bir bilgidir.

Alıntılanabilir kontrol listesi: yapay zekâ destekli Arduino projesi için beş madde

Yukarıdaki akışı tek bir yere toplamak istersen aşağıdaki liste işe yarar. Yazılım öğrenirken yararlanabileceğin diğer konular için Berk Akademi blogundaki yazılara da göz atabilirsin.

1. İsteğe kart modelini, kullandığın bileşenleri ve hangi pinlere bağlı olduklarını yaz.
2. Önerilen bağlantıları kendi devrenle tek tek karşılaştır.
3. Kartı beslemeden önce gerilimi, direnç değerlerini ve ortak GND bağlantısını kontrol et.
4. Önce Serial çıktısıyla ham değerleri gör, sonra davranışı test et.
5. Her denemede tek değişiklik yap ve ne denediğini not et.

Şimdi ilk devreni kur, Serial Monitor'ü aç ve günlüğüne ilk satırı yaz.

Sık Sorulan Sorular

Agentic Mode olmadan da Arduino projesi geliştirilebilir mi?

Evet. Arduino projeleri uzun süredir kod editörü, kütüphane belgeleri ve Serial Monitor ile geliştiriliyor. Yapay zekâ destekli bir mod fikir üretmeyi ve başlangıç taslağını hızlandırabilir, ama devreyi kurmak ve davranışı test etmek yine sana kalır.

Yapay zekânın önerdiği devreyi doğrudan bağlamak güvenli mi?

Önce kendi bileşenlerinle karşılaştırman gerekir. Yanlış pin, uygun olmayan gerilim, eksik direnç ya da ortak bağlanmamış GND kartı ve bileşenleri zorlayabilir. Önerideki her bağlantıyı kart ve bileşen belgeleriyle kontrol et, kartı ancak ondan sonra besle.

Serial Monitor'de anlamsız karakterler görüyorsam ne yapmalıyım?

Önce koddaki Serial.begin() değerine bak, sonra Serial Monitor'de aynı baud hızının seçili olduğunu doğrula. İkisi eşleştiğinde okunabilir metin gelmiyorsa kartın seçili porta bağlı olup olmadığını ve kablonun veri aktardığını kontrol et.

Yapay zekâ önerisindeki kod derleniyor ama devre çalışmıyorsa nereden başlamalıyım?

Derleme yalnızca sözdiziminin doğru olduğunu gösterir, devrenin doğru olduğunu değil. Ham sensör değerini Serial'e yazdır ve değerin ışık gibi bir değişimle tepki verip vermediğine bak. Tepki yoksa bağlantıya, tepki varsa eşik ve çıkış pinine yönel. Her adımda tek değişiklik yapıp günlüğe not et.

Yapay zekâ aracı taslak çıkarabilir, ama devrenin gerçekte ne yaptığını ölçüm ve kayıtlarınla sen anlarsın.