AI Agents · Pelajaran

Kumpulan Alat Umum (Web, Kalkulator, RAG)

Kotak alat awal: cari di web, lakukan perhitungan, dan kueri basis pengetahuan Anda—mencakup 80% demo.

Pelajaran 3 dari 415 langkah

Kumpulan Alat Umum (Web, Kalkulator, RAG) adalah pelajaran AI Agents gratis di CoddyKit. Ini adalah pelajaran 3 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar AI Agents, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus AI Agents mencakup 4 pelajaran total.

Bagian dari pelajaran ini belum diterjemahkan dan ditampilkan dalam bahasa Inggris.

Perangkat Alat Awal

Tiga alat mencakup 80% demo agen:

  1. web_search — mencari di web publik
  2. calculator — mengevaluasi ekspresi matematika
  3. retrieve — mencari basis pengetahuan internal (RAG)

Alat 1: Pencarian Web

Gunakan Tavily, Serper, atau Brave Search API:

import requests

def web_search(query: str, k: int = 5):
    r = requests.post('https://api.tavily.com/search',
        json={'api_key': TAVILY_KEY, 'query': query, 'max_results': k})
    results = r.json()['results']
    return [
        {'title': r['title'], 'url': r['url'], 'snippet': r['content'][:300]}
        for r in results
    ]

Web Search Tool Schema

schema_search = {'type': 'function', 'function': {
    'name': 'web_search',
    'description': 'Search the public web. Use for current events or facts after the knowledge cutoff.',
    'parameters': {'type': 'object', 'properties': {
        'query': {'type': 'string', 'description': 'What to search for'},
        'k': {'type': 'integer', 'default': 5}
    }, 'required': ['query']}
}}
import json
print(json.dumps(schema_search, indent=2))

Alat 2: Kalkulator

Model tidak dapat melakukan aritmetika secara andal di dalam pikirannya. Alat kalkulator memperbaiki sebagian besar kesalahan numerik:

import math

ALLOWED = {k: getattr(math, k) for k in ['sqrt','log','exp','sin','cos','tan','pi','e']}

def calculator(expression: str) -> str:
    try:
        return str(eval(expression, {'__builtins__': {}}, ALLOWED))
    except Exception as e:
        return f'Error: {e}'

print(calculator('sqrt(16) + 2'))

Calculator Tool Schema

schema_calc = {'type': 'function', 'function': {
    'name': 'calculator',
    'description': 'Evaluate a math expression like 2 + 3 * sqrt(16). Use for any arithmetic.',
    'parameters': {'type': 'object', 'properties': {
        'expression': {'type': 'string'}
    }, 'required': ['expression']}
}}
import json
print(json.dumps(schema_calc, indent=2))

Tool 3: RAG / Knowledge Retrieval

from langchain_openai import OpenAIEmbeddings
from langchain_community.vectorstores import Chroma

store = Chroma(persist_directory='./db', embedding_function=OpenAIEmbeddings())

def retrieve(query: str, k: int = 4):
    docs = store.similarity_search(query, k=k)
    return [{'text': d.page_content, 'source': d.metadata.get('source')} for d in docs]

Retrieve Tool Schema

schema_retrieve = {'type': 'function', 'function': {
    'name': 'retrieve',
    'description': 'Search the internal knowledge base for company-specific information (policies, docs, history).',
    'parameters': {'type': 'object', 'properties': {
        'query': {'type': 'string'},
        'k': {'type': 'integer', 'default': 4}
    }, 'required': ['query']}
}}
import json
print(json.dumps(schema_retrieve, indent=2))

Alat 4: Interpreter Kode (Bonus)

Untuk tugas data, berikan agen sandbox Python:

def run_python(code: str) -> str:
    # Use a sandboxed environment (E2B, Firecracker, gVisor)
    return sandbox.run(code).stdout

Alat 5: Pengambilan HTTP (Bonus)

Untuk mengambil URL tertentu (setelah web_search mengembalikan tautan yang menjanjikan):

def fetch_url(url: str) -> str:
    r = requests.get(url, timeout=10)
    return BeautifulSoup(r.text, 'html.parser').get_text()[:5000]

Kiat Mendeskripsikan Alat

  • Sebutkan KAPAN alat digunakan, bukan hanya fungsinya
  • Sebutkan input dan output yang umum
  • Catat keterbatasannya ("hanya berfungsi untuk teks bahasa Inggris", "batas waktu 5 detik")

Hindari Tumpang Tindih Alat

Dua alat dengan tujuan yang tumpang tindih dapat membingungkan model. Jika search_web dan retrieve sama-sama melakukan "pencarian", jelaskan dalam deskripsinya kapan masing-masing harus digunakan.

Evaluasi Penggunaan Alat

Buat set pengujian kecil dengan 50 pertanyaan: masing-masing memiliki alat yang "benar" untuk dipanggil. Jalankan agen Anda; ukur seberapa sering agen memilih alat yang tepat. Ini adalah metrik yang sangat informatif.

Alat Tersembunyi

Beberapa alat berguna, tetapi tidak selalu diperlukan — tampilkan hanya ketika relevan. Misalnya, refund_order hanya ketika pengguna sudah diautentikasi dan menanyakan pengembalian dana.

Cara Terbaik Meningkatkan Pemilihan

Agen Anda terlalu sering memilih alat yang salah. Apa perbaikan paling sederhana?

Ringkasan

Perangkat alat awal: web_search, calculator, retrieve. Bangun, evaluasi, lalu ulangi dengan memperbaiki deskripsinya. Ini mencakup sebagian besar kasus penggunaan agen pada tahap awal.

Gratis untuk memulai

Belajar AI Agents dengan tutor AI — gratis

Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.

Kursus
60
Pelajaran
239

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Kumpulan Alat Umum (Web, Kalkulator, RAG)” gratis?

Ya — teks lengkap “Kumpulan Alat Umum (Web, Kalkulator, RAG)” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus AI Agents, upgrade ke CoddyKit PRO. Kursus AI Agents mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Kumpulan Alat Umum (Web, Kalkulator, RAG)”?

Kotak alat awal: cari di web, lakukan perhitungan, dan kueri basis pengetahuan Anda—mencakup 80% demo. Kamu berlatih AI Agents dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai AI Agents?

Tidak diperlukan pengalaman sebelumnya. AI Agents di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 4.

Berapa lama pelajaran “Kumpulan Alat Umum (Web, Kalkulator, RAG)” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran AI Agents ini?

Ya. Setiap pelajaran AI Agents menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

  1. ReAct: Pola Bernalar + Bertindak
  2. Menerapkan ReAct dari Awal
  3. Kumpulan Alat Umum (Web, Kalkulator, RAG)
  4. Mendeteksi dan Memulihkan dari Galat Alat
← Kembali ke AI Agents