Bila Hendak Menggunakan Ejen
Ejen berbanding arahan ringkas berbanding pipeline tetap
Bila Hendak Menggunakan Ejen ialah pelajaran Claude Architect percuma di CoddyKit. Ini ialah pelajaran 3 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Claude Architect, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Claude Architect merangkumi sejumlah 4 pelajaran.
Tiga Cara Menyelesaikan Tugasan
Sebelum anda membina apa-apa dengan Claude, anda perlu membuat satu keputusan penting: berapa banyak autonomi yang diperlukan oleh tugasan itu? Terdapat tiga corak:
- Gesaan mudah — satu permintaan, satu balasan.
- Saluran paip tetap — urutan langkah yang diketahui dan anda sambungkan sendiri.
- Ejen — model memutuskan alat yang hendak dipanggil dan masanya, lalu mengulang sehingga kerja selesai.
Memilih corak yang betul ialah keputusan seni bina. Bina secara berlebihan dan anda menambah kos serta titik kegagalan; bina terlalu sedikit dan tugasan itu tidak dapat diselesaikan. Pelajaran ini mengajar anda membuat pilihan yang baik.
Gesaan Mudah
Gesaan mudah ialah satu panggilan API: anda menghantar mesej system bersama messages, kemudian menerima satu jawapan. Tiada alat, tiada gelung.
Gunakannya apabila tugasan itu lengkap dengan sendirinya: menulis semula teks, meringkaskan perenggan, mengelaskan ayat atau menjawab soalan berdasarkan konteks yang diberikan. Jika semua yang diperlukan oleh model sudah ada dalam gesaan, anda tidak memerlukan apa-apa lagi.
Ingat: model tidak menyimpan keadaan. Setiap panggilan adalah bebas — anda mesti menghantar semula keseluruhan sejarah messages sendiri jika mahukan kesinambungan.
import anthropic
client = anthropic.Anthropic()
resp = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=512,
system="You rewrite text to be clear and concise.",
messages=[
{"role": "user", "content": "Rewrite: 'The meeting, which was long, ended.'"}
],
)
print(resp.content[0].text)Saluran Paip Tetap
Saluran paip tetap merangkaikan beberapa langkah mengikut susunan yang diketahui. Anda — arkitek — menentukan urutan itu dalam kod. Langkah 1 membekalkan input kepada langkah 2, yang kemudiannya membekalkan input kepada langkah 3.
Ini juga dipanggil perangkaian gesaan. Gunakannya apabila langkah-langkah itu diketahui dan berjujukan: extract_fields, kemudian sahkannya, kemudian format_report. Model tidak pernah memilih laluan — anda yang memilihnya lebih awal.
Saluran paip boleh dijangka dan mudah dinyahpepijat kerana aliran kawalannya tetap. Imbangannya ialah ketegaran: saluran paip tidak dapat menyesuaikan diri apabila tugasan memerlukan langkah yang berbeza bergantung pada perkara yang ditemui.
# Fixed pipeline: each step's output feeds the next
extracted = extract_fields(document) # step 1
validated = validate(extracted) # step 2
report = format_report(validated) # step 3
# The sequence is hard-coded. The model never picks the path.Ejen
Ejen menyerahkan kawalan aliran kepada model. Anda memberikan Claude matlamat dan sekumpulan tools, kemudian model memutuskan alat yang hendak dipanggil, memeriksa hasilnya dan menentukan perkara yang perlu dilakukan seterusnya — mengulang sehingga matlamat dicapai.
Ciri penentu: keputusan dipacu model, bukan dikod keras. Anda tidak tahu lebih awal berapa banyak langkah yang akan diambil atau alat mana yang akan digunakan.
Gunakan ejen apabila laluannya terbuka: menyiasat pepijat, membuat penyelidikan tentang topik merentas sumber atau menyelesaikan isu pelanggan yang mungkin memerlukan carian, pemulangan wang atau peningkatan kepada pihak lain bergantung pada perkara yang ditemui.
resp = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=1024,
system="You are a support agent. Resolve the customer's issue.",
tools=[get_customer, lookup_order, process_refund, escalate_to_human],
messages=conversation,
)
# The model chooses which tool(s) to call based on the situation.Gelung Ejen
Ejen menjalankan gelung yang dipacu oleh stop_reason daripada respons:
- Hantar permintaan.
- Periksa
stop_reason. - Jika nilainya
tool_use, jalankan alat yang diminta, tambahkan hasilnya pada sejarah mesej dan hantar semula. - Ulang sehingga
stop_reasonialahend_turn.
Anda menamatkan berdasarkan sebab hentian — isyarat API sendiri bahawa giliran itu selesai. Inilah teras setiap ejen.
while True:
resp = client.messages.create(model=MODEL, max_tokens=1024,
system=SYSTEM, tools=TOOLS,
messages=messages)
messages.append({"role": "assistant", "content": resp.content})
if resp.stop_reason == "end_turn":
break # task complete
if resp.stop_reason == "tool_use":
results = run_tools(resp.content)
messages.append({"role": "user", "content": results})Jangan Sekali-kali Menghuraikan Teks untuk Mencari 'Selesai'
Kesilapan yang biasa dan berbahaya: menamatkan gelung dengan mengimbas balasan model untuk perkataan seperti "selesai" atau "telah tamat". Model mungkin menyebut "selesai" di tengah-tengah pemikiran, atau langsung tidak menyebutnya. Ini ialah anti-corak klasik.
Sentiasa tamatkan pada stop_reason — end_turn bermaksud selesai. Sebab hentian ialah isyarat berstruktur yang boleh dipercayai; teks bebas bukan begitu.
Had lelaran (bilangan maksimum gelung) ialah jaring keselamatan untuk mencegah gelung tidak terkawal — bukan mekanisme hentian utama. Hentian sebenar sentiasa ialah sebab hentian.
# ANTI-PATTERN: do not do this
if "done" in resp.content[0].text.lower():
break
# CORRECT: rely on the structured stop reason
if resp.stop_reason == "end_turn":
breakPeraturan Keputusan: Adakah Laluan Diketahui?
Inilah satu-satunya soalan yang menentukan pilihan antara ejen dengan saluran paip:
Adakah anda mengetahui langkah-langkahnya lebih awal?
- Ya, tetap dan berjujukan → gunakan saluran paip tetap (perangkaian gesaan). Ia lebih murah, lebih pantas dan lebih mudah dinyahpepijat.
- Tidak, penyiasatan terbuka → gunakan ejen dengan penguraian adaptif.
Jika tugasan itu langsung tidak memerlukan data atau tindakan luaran dan boleh dimuatkan dalam satu panggilan, anda tidak memerlukan saluran paip pun — gesaan mudah sudah mencukupi. Sentiasa pilih corak paling mudah yang dapat menyelesaikan kerja.
Keputusan berbanding Jaminan
Ejen berkuasa kerana model yang membuat keputusan — tetapi keputusan model adalah ber kebarangkalian (kira-kira 90% boleh dipercayai), bukan pasti. Jadi, peraturan kedua turut terpakai:
Biarkan model memutuskan; simpan kod keras untuk jaminan.
Apabila tindakan yang salah mempunyai akibat kewangan, undang-undang atau keselamatan — seperti pemulangan wang yang besar — jangan bergantung pada gesaan. Kuatkuasakan peraturan itu secara deterministik dengan cangkuk atau prasyarat secara program. Gesaan membimbing; cangkuk menjamin.
Jadi, ejen ialah bentuk yang betul dan peraturan kritikal masih dikuatkuasakan dalam kod di sekelilingnya. Kedua-duanya tidak bercanggah.
# Prompt guidance is ~90% reliable — fine for routine routing.
# A hook is 100% deterministic — use it for critical rules:
# block process_refund when amount > 500
# block process_refund until get_customer returns a verified ID
# Outgoing-call hooks reject policy-violating actions before they run.Apabila Saluran Paip Mengatasi Ejen
Jangan memilih ejen hanya kerana ia kelihatan moden. Saluran paip tetap lebih baik apabila:
- Urutan langkah diketahui dan stabil.
- Anda mahukan kos dan kependaman yang boleh dijangka (tanpa gelung terbuka).
- Anda memerlukan aliran kawalan yang mudah untuk diuji dan dinyahpepijat.
Contoh: pengekstrakan data berstruktur yang sentiasa mengekstrak, kemudian mengesahkan, kemudian memformat. Laluan itu tidak pernah berubah, jadi pengekodan keras ialah pilihan yang betul dan kukuh. Menambah autonomi ejen di sini hanya menambah ketidakdeterministikan dan kos tanpa sebarang manfaat.
Apabila Ejen Ialah Pilihan yang Betul
Pilih ejen apabila kerja itu benar-benar terbuka dan laluan bergantung pada perkara yang ditemui sepanjang proses:
- Penyiasatan pepijat — cari titik masuk dengan grep, baca fail dan ikuti penggunaannya; anda tidak boleh menskripkan laluan lebih awal.
- Penyelidikan pelbagai sumber — penyelaras menguraikan soalan dan mewakilkannya kepada subejen.
- Sokongan pelanggan — satu isu memerlukan carian, isu lain memerlukan pemulangan wang dan isu lain lagi memerlukan peningkatan kepada pihak lain.
Dalam semua kes ini, langkah seterusnya bergantung pada hasil terakhir. Kebergantungan itulah yang boleh dikendalikan oleh gelung ejen tetapi tidak oleh saluran paip tetap.
system=("You are a debugging agent. Investigate the failing test "
"and find the root cause.")
tools=[glob_tool, grep_tool, read_tool, bash_tool]
# The model adapts: Grep entry points -> Read files -> Grep usages
# -> Read consumers. The route is decided at runtime, not by you.Senarai Semak Praktikal
Jalankan setiap tugasan baharu melalui senarai semak ringkas ini:
- Satu panggilan yang lengkap dengan sendirinya? → gesaan mudah.
- Urutan langkah yang diketahui dan tetap? → saluran paip tetap.
- Terbuka, laluannya bergantung pada hasil? → ejen.
- Peraturan kritikal (wang / undang-undang / keselamatan)? → kuatkuasakan dengan cangkuk, tanpa mengira corak yang dipilih.
Gunakan corak paling mudah yang berfungsi sebagai lalai. Tambah autonomi hanya apabila tugasan benar-benar memerlukannya — dan tambah penguatkuasaan deterministik di mana-mana kesilapan akan merugikan. Keseimbangan itulah yang membezakan arkitek daripada pengubah suai sembarangan.
Semakan Pantas
Uji pembuatan keputusan anda berdasarkan senario yang realistik.
Imbas Kembali: Memilih Corak Anda
Intipati utama:
- Gesaan ringkas — serba lengkap, satu panggilan, tiada keadaan (hantar semula keseluruhan sejarah sendiri).
- Saluran paip tetap — langkah yang diketahui dan berjujukan; boleh dijangka, murah dan mudah dinyahpepijat.
- Ejen — laluan terbuka yang diputuskan oleh model pada masa jalan melalui gelung ejen.
- Gelung ditamatkan apabila
stop_reason == end_turn, tidak sekali-kali dengan menghuraikan teks; had lelaran hanyalah jaring keselamatan. - Keputusan model bersifat kebarangkalian; kuatkuasakan peraturan kritikal berkaitan wang, undang-undang dan keselamatan dengan cangkuk atau prasyarat secara program untuk jaminan yang tentu.
- Gunakan corak paling ringkas yang dapat melaksanakan tugas sebagai pilihan lalai.
Kuasai pilihan ini dan seluruh seni bina ejen yang seterusnya dapat dibina dengan kemas di atasnya.
Pelajari Python dengan tutor kecerdasan buatan — percuma
Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.
- Kursus
- 26
- Pelajaran
- 104
Soalan Lazim
Adakah pelajaran “Bila Hendak Menggunakan Ejen” percuma?
Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Claude Architect, termasuk “Bila Hendak Menggunakan Ejen”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Claude Architect merangkumi sejumlah 4 pelajaran.
Apakah yang akan saya pelajari dalam “Bila Hendak Menggunakan Ejen”?
Ejen berbanding arahan ringkas berbanding pipeline tetap Anda berlatih Claude Architect menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.
Adakah saya memerlukan pengalaman untuk memulakan Claude Architect?
Tiada pengalaman terdahulu diperlukan. Pembelajaran Claude Architect di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 3 daripada 4.
Berapa lamakah pelajaran “Bila Hendak Menggunakan Ejen” diambil?
Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.
Bolehkah saya menulis dan menjalankan kod dalam pelajaran Claude Architect ini?
Ya. Setiap pelajaran Claude Architect menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.
Semua pelajaran dalam kursus ini
- Perkara yang Menjadikan Sistem Bersifat Ejen
- Keputusan Dipacu Model berbanding Berkod Tetap
- Bila Hendak Menggunakan Ejen
- Gambaran Keseluruhan Gelung Ejen