All Products
Search

This Product

    Platform For AI:Konfigurasikan Tools untuk Agent

    Document Center

    Platform For AI:Konfigurasikan Tools untuk Agent

    Last Updated:Apr 24, 2026

    Konfigurasikan berbagai tools untuk memperluas kemampuan Agent melalui integrasi layanan eksternal, eksekusi kode, dan pengambilan pengetahuan.

    Ikhtisar Tool

    LangStudio menyediakan lima jenis tool untuk mengintegrasikan berbagai bentuk kemampuan eksternal:

    • MCP Tool: Daftarkan layanan backend yang sesuai protokol MCP ke platform sehingga Agent dapat memanggilnya sesuai kebutuhan untuk berinteraksi secara aman dengan sistem eksternal.

    • Custom Tool (OpenAPI Tool): Sediakan file spesifikasi OpenAPI 3.0+ yang secara otomatis dikonversi oleh platform menjadi tool yang dapat dipanggil, dengan satu tool per titik akhir API.

    • Python Tool: Tulis fungsi Python, dan platform secara otomatis mengekstrak signature fungsi, anotasi tipe, serta dokumentasi untuk menghasilkan deskripsi terstruktur guna pemanggilan oleh Agent.

    • Knowledge Base Tool: Konfigurasikan basis pengetahuan enterprise yang sudah ada langsung ke node Agent sehingga memungkinkan pengambilan pengetahuan privat sesuai permintaan selama inferensi.

    • Web Search Tool: Ambil informasi real-time melalui mesin pencari internet, dengan Agent secara otomatis memanggil tool ini untuk menanyakan berita terbaru, data faktual, dan konten web lainnya.

    Pilih jenis tool yang sesuai berdasarkan kasus penggunaan Anda:

    Tipe Alat

    Kasus Penggunaan

    Fitur Utama

    MCP Tool

    Layanan mikro internal, API privat

    Integrasi berbiaya rendah, observabilitas bawaan

    Custom Tool

    SaaS pihak ketiga, layanan RESTful

    Integrasi tanpa kode

    Python Tool

    Pemrosesan logika kompleks, komputasi lokal

    Pemrograman fleksibel, integrasi mendalam dengan ekosistem Python

    Knowledge Base Tool

    Tanya jawab berbasis pengetahuan proprietary

    Siap pakai, pengambilan otomatis oleh Agent

    Web Search Tool

    Kueri informasi real-time, berita terbaru

    Pengambilan web otomatis

    Panduan Kombinasi dan Pemilihan Tool:

    • Satu Agent dapat dikonfigurasi dengan beberapa tools. Misalnya, gabungkan MCP Tool (panggilan API internal) dan Python Tool (pemrosesan data) untuk menangani logika bisnis yang kompleks.

    • Jika API internal belum menerapkan protokol MCP tetapi memiliki spesifikasi OpenAPI, mulailah dengan Custom Tool untuk integrasi cepat, lalu migrasikan ke MCP Tool nanti demi observabilitas yang lebih baik.

    Konfigurasikan MCP Tool

    Buat Koneksi MCP Tool

    1. Buka LangStudio, navigasi ke Tools > MCP Tool, lalu klik Create Tool.

    2. Pilih metode pembuatan:

      • FunctionAI: Konfigurasikan layanan MCP yang dibuat melalui Explore > MCP Template.

        • Pilih layanan MCP yang telah dideploy; sistem akan secara otomatis mengisi parameter koneksi.

      • Custom: Konfigurasikan layanan MCP yang Anda deploy sendiri atau host di platform pihak ketiga.

        • transport: Protokol transport dasar untuk berkomunikasi dengan layanan MCP. Mendukung SSE dan StreamableHTTP.

        • url: URL titik akhir akses lengkap dari layanan MCP.

        • authentication: Konfigurasikan informasi autentikasi untuk mengakses layanan MCP. Mendukung tiga jenis berikut:

          • BearerAuth: Gunakan autentikasi token Bearer. Masukkan token akses yang valid di bidang token.

          • Other: Masukkan auth_header_name dan token untuk menentukan header permintaan mana yang menyediakan token.

          • None: Tidak memerlukan autentikasi.

    3. (Opsional) Jalankan connectivity test untuk memverifikasi layanan MCP dapat diakses.

    4. Klik Submit untuk membuat tool.

    Konfigurasikan Node Agent

    Pada halaman konfigurasi node Agent, temukan MCP Tool. Dua metode konfigurasi didukung:

    • Pilih koneksi MCP tool yang sudah ada: Pertama-tama buat koneksi MCP tool yang dapat digunakan kembali. Lihat Create MCP Tool Connection untuk detailnya. Satu layanan MCP biasanya menyediakan beberapa tools; Anda dapat mengatur cakupan tool dan meminta persetujuan untuk tool tertentu.

      • Gunakan opsi tool scope untuk mengontrol tool mana yang terlihat oleh model.

      • Untuk tool dengan operasi sensitif (seperti memodifikasi data pengguna), aktifkan fitur Approval tools sebagai perlindungan. Saat alur kerja mencapai tool tersebut, node secara otomatis berhenti sementara dan menunggu konfirmasi manual; alur kerja hanya dilanjutkan setelah disetujui.

    • Konfigurasi MCP kustom: Hanya tersedia dalam node ini.

    image

    Konfigurasikan Jenis Tool Lainnya

    Pada halaman konfigurasi node Agent, navigasi ke Tools untuk menambahkan berbagai tool. Untuk tool yang dipilih, Anda dapat mengedit deskripsi tool, "Needs Approval", dan parameter lainnya.image

    • Knowledge Base: Lihat Manage knowledge bases untuk membuat basis pengetahuan sebelum menambahkannya ke Agent.

    • Custom Tool (OpenAPI Tool):

      • Pilih custom tool yang sudah ada atau Create Custom Tool.

      • Buat tool dari layanan LangStudio yang sudah dideploy di PAI-EAS, atau masukkan secara manual spesifikasi OpenAPI.

      • Setelah membuat tool, buka halaman detail tool dan gunakan fitur Test untuk mengirim permintaan contoh dan memverifikasi tanggapan.

    • Python Tool:

      • Pilih tool yang sudah ada atau Create Python Tool.

      • Jika membuat tool baru, atur nama toolset, lalu edit kode dan uji pada halaman yang terbuka.

      • Lihat atau edit Python tool yang sudah ada: Klik More > Code-only Mode di pojok kanan atas halaman pengembangan aplikasi. File berada di folder tools di bawah direktori sumber aplikasi.

    • Web Search Tool: Menggunakan Alibaba Cloud IQS-Standard Search. Setelah menambahkan tool, lihat IQS-GenericSearch untuk konfigurasi.