osFoundry / Platform
Konfigurasi alat
Definisikan alat baru sebagai input + handler. Apa pun yang dapat Anda panggil dari Maestro.
Apa itu
Tool config adalah cara Anda mengajari agen osFoundry melakukan hal yang tidak tersedia dari fitur bawaan. Sebuah tool config adalah definisi kecil dengan dua bagian: input yang diterimanya (parameter bernama beserta tipenya) dan sebuah handler (apa yang benar-benar berjalan saat tool dipanggil). Setelah didefinisikan, tool itu bergabung ke kumpulan hal yang bisa dipanggil Maestro, runtime agen osFoundry, saat bekerja, sama seperti ia memakai chat, pencarian, atau operasi file. Jika Anda bisa menggambarkan sebuah aksi sebagai "ini argumennya, ini yang dijalankan", Anda bisa mengubahnya menjadi tool yang dipanggil agen Anda berdasarkan nama.
Di dalam osFoundry, ini berada di Studio, bersama konfigurasi agen dan workflow lainnya, sehingga tool yang Anda definisikan tersedia bagi agen, loop, dan tim yang Anda bangun di workspace yang sama. Karena osFoundry bersifat bring-your-own-key dan local-first, handler berjalan dari workspace Anda dengan kredensial dan key milik Anda sendiri: tidak ada reseller yang menyisip di antara agen Anda dan layanan yang dipanggilnya, serta tidak ada batasan per-seat atas berapa banyak tool yang Anda definisikan atau seberapa sering ia berjalan. Skema input adalah yang dibaca model untuk memutuskan kapan dan bagaimana memanggil tool, jadi kumpulan input bernama yang jelas itulah yang membuat agen memakainya dengan benar; handler adalah bagian yang Anda kendalikan dari awal sampai akhir.
Mengapa ini penting: sebagian besar pekerjaan agen yang nyata bergantung pada aksi spesifik untuk stack Anda, seperti mengakses API internal, menjalankan skrip, atau menarik data dari sistem yang hanya bisa Anda akses. Alih-alih menunggu fitur yang mencakup tiap kasus, tool config membuat Anda bisa menambahkan tepat kapabilitas yang dibutuhkan dan langsung dipakai Maestro. Tool itu menjadi blok yang bisa dipakai ulang: definisikan sekali, dan setiap agen atau workflow di workspace bisa memanggilnya.
Kemampuan utama
- Definisikan tool dari dua bagian: input yang diterimanya dan handler yang berjalan saat dipanggil
- Input bernama dan bertipe memberi model kontrak yang jelas tentang kapan dan bagaimana memanggil tool
- Tool apa pun yang Anda definisikan bisa dipanggil oleh Maestro, runtime agen osFoundry, berdasarkan nama
- Handler berjalan dari workspace Anda sendiri dengan key Anda: BYOK, tanpa reseller di jalurnya
- Pakai ulang tool yang sudah didefinisikan di seluruh agen, loop, dan tim yang Anda bangun di Studio yang sama
Kasus penggunaan
- Developer: membungkus endpoint REST internal sebagai tool dengan input bertipe agar agen bisa mengkuerinya saat mengerjakan tugas tanpa menghardcode panggilan
- Ops engineer: mendefinisikan tool yang handler-nya menjalankan skrip pemeliharaan, lalu membiarkan agen terjadwal memanggilnya sebagai langkah rutin
- Team lead: menambahkan satu tool lookup kustom di Studio dan memakainya ulang di setiap agen dan workflow di workspace alih-alih membangun ulang di tiap agen
Pertanyaan yang sering diajukan
Apa sebenarnya tool config di osFoundry?
Ini adalah definisi dengan dua bagian: input yang diterima tool (parameter bernama dan bertipe) dan handler yang berjalan saat tool dipanggil. Setelah Anda definisikan, tool tersedia untuk dipanggil Maestro selagi agen bekerja.
Apa yang bisa dilakukan handler sebuah tool?
Handler adalah aksi yang berjalan saat dipanggil. Prinsip dasarnya: sebuah tool bisa apa saja yang bisa Anda panggil dari Maestro. Anda mendefinisikan input yang dikirim agen, dan handler mengerjakan tugasnya memakai workspace dan kredensial Anda sendiri.
Apa bedanya ini dengan plugin platform hosted?
osFoundry bersifat bring-your-own-key dan local-first, jadi tool berjalan dari workspace Anda dengan key Anda, bukan lewat reseller, dan tidak ada biaya per-seat yang membatasi jumlah yang Anda definisikan. Anda menambahkan kapabilitas yang dibutuhkan alih-alih menunggu fitur bawaan mencakupnya.