Tool calling dan actions

Day 12 of 30 · AI Generatif 2026: Bangun Aplikasi AI dan Agen

One-liner: Hubungkan model ke tools dan batasi actions yang berisiko.
Time: 20 hingga 30 menit
Deliverable: Tool Schema dan Contoh Action

Learning goal

You will be able to: Menentukan tool schema dan menjalankan tool call yang aman.

Success criteria (observable)

Tool schema mencakup nama, input, dan bentuk output.
Tool call berjalan dengan contoh nyata.
Action berisiko diblokir.

Output you will produce

Deliverable: Tool Schema dan Contoh Action
Format: JSON schema dan test log
Where saved: Di folder kursus dalam /generative-ai-2026-build-ai-apps-and-agents-id/

Who

Primary persona: Digital nomad yang membangun AI dengan tools Secondary persona(s): Pengguna yang memicu action Stakeholders (optional): Mitra pembangunan

What

What it is

Definisi tool yang menjelaskan apa yang bisa dipanggil model dan bagaimana. Contoh kecil yang membuktikan tool call berjalan sesuai harapan.

What it is not

Bukan platform otomatisasi penuh. Bukan sistem izin yang kompleks.

2-minute theory

Tool calling membuat AI berguna di luar teks.
Schema jelas mengurangi error input.
Guardrails mencegah action berbahaya.

Key terms

Tool schema: Definisi terstruktur untuk input dan output tool.
Guardrail: Aturan untuk mencegah action berisiko.

Where

Applies in

Agent workflows
Backend services

Does not apply in

Konten statis tanpa action

Touchpoints

Tool definitions
Action logs
Permission checks

When

Use it when

Anda ingin AI memicu action
Anda butuh input yang konsisten

Frequency

Setiap menambah tool baru

Late signals

Tool call sering gagal karena input buruk
Action tidak terduga terjadi

Why it matters

Practical benefits

AI lebih berguna
Automasi lebih stabil
Keamanan dan kepercayaan meningkat

Risks of ignoring

Workflow rusak
Action berbahaya terjadi

Expectations

Improves: keandalan dan keamanan
Does not guarantee: keputusan sempurna

How

Step-by-step method

Tentukan nama tool dan tujuannya.
Definisikan input fields dan types.
Tentukan bentuk output.
Tambahkan guardrails untuk action berisiko.
Jalankan test call dan catat hasil.

Do and don't

Validasi input sebelum eksekusi
Log setiap action

Don't

Menjalankan tool tanpa checks
Membuka action berbahaya secara default

Common mistakes and fixes

Mistake: Schema terlalu longgar. Fix: Tambah field wajib dan types.
Mistake: Tidak ada guardrails. Fix: Blokir parameter berisiko.

Done when

Tool schema didefinisikan dan diuji.
Guardrails memblokir input berisiko.
Log menunjukkan call berhasil.

Guided exercise (10 to 15 min)

Inputs

Satu ide tool
Contoh input

Steps

Tulis tool schema.
Tambahkan guardrails untuk input berisiko.
Jalankan test call dan catat output.

Output format

Field	Value
Tool name
Input schema
Guardrails
Test result

Pro tip: Jika tool bisa mengubah data, tambahkan langkah konfirmasi.

Independent exercise (5 to 10 min)

Task

Tambahkan satu guardrail lagi dan ulangi test.

Output

Schema yang diperbarui dan test log baru.

Self-check (yes/no)

Apakah schema jelas dan typed?
Apakah action berisiko diblokir?
Apakah test call tercatat?
Apakah log disimpan?

Baseline metric (recommended)

Score: 1 tool call sukses dengan guardrails
Date: 2026-02-07
Tool used: Notes app

Bibliography (sources used)

OpenAI Tools Guide. OpenAI. 2026-02-06. Read: https://platform.openai.com/docs/guides/tools
OWASP API Security Top 10. OWASP. 2024-01-01. Read: https://owasp.org/www-project-api-security/