Kejuruteraan Arahan AI · Pelajaran

Corak Gesaan Pengepala-Badan-Pengaki

Struktur gesaan yang konsisten dan boleh dikembangkan untuk gesaan berbilang tugasan yang kompleks.

Pelajaran 3 daripada 413 langkah

Corak Gesaan Pengepala-Badan-Pengaki ialah pelajaran Kejuruteraan Arahan AI 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 Kejuruteraan Arahan AI, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Kejuruteraan Arahan AI merangkumi sejumlah 4 pelajaran.

Arahan sebagai Dokumen

Dokumen panjang — laporan, artikel, e-mel — menggunakan struktur Pengepala/Badan/Pengaki kerana mudah dinavigasi secara mental. Pembaca tahu perkara yang boleh dijangka dalam setiap bahagian.

Prinsip yang sama terpakai pada arahan. Apabila arahan berkembang melebihi beberapa ayat, struktur Pengepala/Badan/Pengaki menjadikannya mudah diimbas, diselenggara dan konsisten.

Corak ini berfungsi merentas model dan boleh diskalakan daripada arahan ringkas kepada arahan yang sangat kompleks.

Bahagian Pengepala

Pengepala menjawab dua soalan: Siapakah anda? dan Apakah tugasnya?

Pengepala menetapkan identiti model (persona atau peranan) dan menyatakan matlamat utama arahan. Segala-galanya yang lain dibina berdasarkan asas ini.

Pengepala yang baik adalah ringkas — biasanya 2-4 ayat. Pengepala tidak mengandungi contoh, kekangan atau peraturan hasil.

header = '''
<header>
You are an expert technical writer specializing in API documentation.
Your task is to write clear, developer-friendly documentation
for the API endpoint described in the body of this prompt.
</header>
'''

print(header)

Bahagian Badan

Badan mengandungi kandungan atau konteks yang diperlukan oleh model untuk melaksanakan tugas. Inilah zon data utama:

Dokumen sumber untuk diproses
Sejarah perbualan
Data berstruktur (petikan JSON, CSV)
Bahan rujukan
Masukan sebenar pengguna

Badan ialah bahagian terbesar dan paling kerap dimasukkan secara dinamik semasa masa jalan.

def build_body(endpoint_spec):
    return f'''
<body>
<endpoint_specification>
{endpoint_spec}
</endpoint_specification>
</body>
'''

spec = 'POST /api/v2/users\nRequest body: {email: string, role: admin|user}\nReturns: {id: string, created_at: ISO8601}'
print(build_body(spec))

Bahagian Pengaki

Pengaki mengandungi arahan pemformatan dan skema hasil. Pengaki muncul terakhir kerana:

Model membaca dari atas ke bawah dan menggunakan peraturan pemformatan pada perkara yang baru diproses
Arahan pemformatan yang hampir dengan penghujung kurang berkemungkinan diabaikan
Pengaki sering boleh digunakan semula merentas arahan yang mempunyai jenis hasil yang sama

Pengaki hendaklah jelas: Kembalikan objek JSON dengan medan ini, bukannya formatkan dengan kemas.

footer = '''
<footer>
Format your response as a JSON object with these fields:
{
  "endpoint": "string",
  "summary": "string (one sentence)",
  "parameters": [{"name": "string", "type": "string", "required": true|false, "description": "string"}],
  "response_example": "string (JSON)",
  "error_codes": [{"code": "number", "meaning": "string"}]
}
Do not include any text outside the JSON object.
</footer>
'''

print(footer)

Menyusun Corak Lengkap

Menggabungkan Pengepala, Badan dan Pengaki ke dalam fungsi arahan yang lengkap dan boleh digunakan semula:

def build_api_doc_prompt(endpoint_spec):
    header = '<header>\nYou are an expert technical writer. Document the API endpoint in the body.\n</header>'
    body = f'<body>\n<endpoint>\n{endpoint_spec}\n</endpoint>\n</body>'
    footer = '<footer>\nReturn JSON: {"summary": str, "parameters": [...], "response_example": str}\nNo text outside JSON.\n</footer>'
    return '\n\n'.join([header, body, footer])

spec = 'GET /api/products/:id\nReturns product details by ID'
print(build_api_doc_prompt(spec))

Mengapa Susunan Ini Berkesan

Susunan Pengepala/Badan/Pengaki mencerminkan cara model memproses konteks:

Pengepala dahulu — menetapkan identiti dan matlamat, lalu menyediakan model untuk perkara seterusnya
Badan kedua — model kini memproses kandungan melalui sudut pandang peranan dan tugas yang telah ditetapkan
Pengaki terakhir — arahan pemformatan muncul betul-betul sebelum model menjana jawapannya, lalu memaksimumkan pengaruhnya terhadap struktur hasil

Meletakkan arahan pemformatan dalam pengepala (paling awal) menyebabkan model melupakannya sebahagian apabila tiba masa menulis jawapannya.

Menskalakan Gesaan Kompleks

Corak Pengepala/Badan/Pengaki berkembang secara semula jadi apabila gesaan menjadi kompleks:

def build_complex_prompt(persona, task, context_docs, constraints, output_schema):
    header = f'<header>\n{persona}\nTask: {task}\n</header>'

    docs = '\n'.join(f'<document id="{i+1}">\n{d}\n</document>' for i, d in enumerate(context_docs))
    body = f'<body>\n{docs}\n</body>'

    constraint_list = '\n'.join(f'- {c}' for c in constraints)
    footer = f'<footer>\n<constraints>\n{constraint_list}\n</constraints>\n<output_schema>\n{output_schema}\n</output_schema>\n</footer>'

    return '\n\n'.join([header, body, footer])

Menggunakan Semula Templat Pengaki

Oleh sebab pengaki menentukan struktur keluaran, bahagian ini paling mudah digunakan semula. Templat pengaki yang lazim:

FOOTER_JSON = '<footer>\nReturn a valid JSON object. No text outside JSON. No markdown code fences.\n</footer>'

FOOTER_MARKDOWN = '<footer>\nFormat your response as markdown.\nUse ## for section headers.\nUse bullet points for lists.\nMaximum 500 words.\n</footer>'

FOOTER_STRUCTURED = '<footer>\nRespond using this exact structure:\n1. Summary (1 sentence)\n2. Key Findings (bullet list)\n3. Recommendation (1 paragraph)\n</footer>'

print('Footer templates ready for reuse.')

Menyuntik Kandungan Dinamik dalam Badan

Badan ialah bahagian yang paling kerap dibina secara dinamik semasa pelaksanaan. Amalan terbaik untuk penyuntikan badan dinamik:

Sentiasa apitkan kandungan yang disuntik dalam teg XML bernama
Bersihkan masukan pengguna sebelum penyuntikan untuk mencegah penyuntikan gesaan
Pendekkan dokumen yang sangat panjang dan nyatakan pemendekan itu dalam badan
Namakan setiap bahagian yang disuntik dengan jelas (dokumen_1, pertanyaan_pengguna, sejarah_sembang)

def safe_inject(user_content, max_chars=3000):
    safe = user_content.replace('<', '&lt;').replace('>', '&gt;')
    if len(safe) > max_chars:
        safe = safe[:max_chars] + '... [TRUNCATED]'
    return f'<user_input>\n{safe}\n</user_input>'

raw = 'User provided text here. Could be very long.'
print(safe_inject(raw))

Struktur Konsisten Merentas Pangkalan Kod

Kekuatan sebenar Pengepala/Badan/Pengaki terserlah apabila seluruh aplikasi anda menggunakan corak yang sama secara konsisten. Manfaatnya:

Ahli pasukan baharu memahami mana-mana gesaan dengan serta-merta
Semakan gesaan dalam semakan kod lebih mudah — penyemak tahu dengan tepat tempat untuk melihat
Pengujian automatik boleh mengesahkan setiap bahagian secara berasingan
Pemindahan gesaan antara model mudah dilakukan — hanya kandungan yang berubah, bukan struktur

Kesilapan Lazim dalam Pengepala/Badan/Pengaki

Kesilapan yang menjejaskan keberkesanan corak ini:

Arahan format dalam pengepala — terlalu jauh daripada penjanaan respons; model mengabaikannya sebahagian
Huraian tugas tertanam dalam badan — model mungkin menganggapnya sebagai data untuk diproses, bukan arahan
Kekangan dipecahkan merentas bahagian — sukar diaudit dan menyebabkan percanggahan
Tiada pengaki — struktur keluaran menjadi tidak dapat diramal apabila kerumitan gesaan meningkat

Semakan Pantas

Di manakah arahan format keluaran patut diletakkan dalam corak Pengepala/Badan/Pengaki, dan mengapa?

Jawab dalam pelajaran interaktif

Pengepala/Badan/Pengaki — Kesimpulan Utama

Corak Pengepala/Badan/Pengaki membawa disiplin struktur dokumen kepada kejuruteraan gesaan:

Pengepala: Siapa diri anda + tugas — menetapkan kerangka untuk segala-galanya selepas itu
Badan: Kandungan dan konteks — disuntik secara dinamik serta diapit dalam teg XML semantik
Pengaki: Arahan format dan skema keluaran — diletakkan terakhir untuk memberikan pengaruh maksimum terhadap struktur keluaran
Corak ini berkembang secara semula jadi daripada gesaan ringkas kepada gesaan yang sangat kompleks
Templat pengaki boleh digunakan semula merentas gesaan dengan jenis keluaran yang sama
Konsistensi merentas pangkalan kod menjadikan gesaan mudah disemak, diuji dan diselenggara

Percuma untuk bermula

Pelajari Kejuruteraan Arahan AI 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: 53
Pelajaran: 199

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Corak Gesaan Pengepala-Badan-Pengaki” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Kejuruteraan Arahan AI, termasuk “Corak Gesaan Pengepala-Badan-Pengaki”, 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 Kejuruteraan Arahan AI merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Corak Gesaan Pengepala-Badan-Pengaki”?

Struktur gesaan yang konsisten dan boleh dikembangkan untuk gesaan berbilang tugasan yang kompleks. Anda berlatih Kejuruteraan Arahan AI 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 Kejuruteraan Arahan AI?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Kejuruteraan Arahan AI 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 “Corak Gesaan Pengepala-Badan-Pengaki” 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 Kejuruteraan Arahan AI ini?

Ya. Setiap pelajaran Kejuruteraan Arahan AI 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

← Kembali ke Kejuruteraan Arahan AI