Tool Policy
Buka di CMSHalaman Tool Policy menentukan apa yang dilakukan setiap tool agent Anda dalam simulasi saat tidak ada mock yang menjawab panggilan. Terdapat di sidebar agent pada Simulation → Tool Policy; item menu ini hanya muncul jika fitur mock diaktifkan. Mock sendiri Anda buat di layar Tool Mocks dan di form Scenarios.
Halaman ini tidak memakai AI: pengaturan yang sama memberi keputusan yang sama setiap kali. Jawaban agent dan penilaian kriteria dalam sebuah run dihasilkan oleh AI dan bisa berbeda antara dua run dari skenario yang sama. Siapa pun dengan peran Owner atau Contributor pada agent bisa mengubah sakelar Run live, dan sakelar itu berlaku untuk semua skenario.
Header Halaman
Halaman ini berjudul Tool Policy, dengan teks "What each tool does in simulations when no mock answers the call. Applies to every scenario of this agent, on both Draft and Published."
Jika halaman tidak dapat dimuat, tampil "Failed to load the tool policy." dengan tombol Retry. Saat tool versi Draft dan Published sama-sama tidak dapat dibaca, tampil "The tools of the Draft and Published versions couldn't be loaded, so the tool policy can't be edited right now." Saat agent tidak punya tool yang dapat diatur, tampil "This agent has no tools that can be set here."
Jika tool salah satu versi tidak dapat dimuat, sebuah pemberitahuan muncul di atas grup: "The Draft version couldn't be loaded, so settings for tools found only there are kept unchanged." (atau Published; atau, saat keduanya gagal, "The Draft and Published versions couldn't be loaded, so settings that can't be checked are kept unchanged.").
Cara Panggilan Tool Diputuskan
Card berjudul How a tool call is decided in a simulation. Card ini menunjukkan urutan lima langkah, dari kiri ke kanan, sebagai chip. Langkah pertama yang punya jawaban untuk panggilan itulah yang menang.
| Step mocks | Mock set yang terpasang di step yang melakukan panggilan. |
| Scenario mocks | Mock set yang terpasang di seluruh skenario. |
| Scenario's Allow live | Pengaturan Allow live skenario untuk tool tersebut, yang diatur di panel tool pada form skenario. |
| This policy | Pengaturan di halaman ini. |
| Built-in default | Apa yang dilakukan tool saat tidak ada langkah di atas yang berlaku. |
Catatan di bawah chip berbunyi: "Mocks always win, so a tool that runs live here can still be mocked in the scenarios that need specific answers."
Grup Tool
Di bawah filter, tool berada dalam empat grup, masing-masing sebuah card yang dapat dibuka dan ditutup. Setiap card menampilkan judul, baris hitungan, dan, untuk dua yang pertama, chip default-nya.
| Effect unknown | Chip: Default: Blocked. Terbuka secara default. Tool yang efeknya tidak dapat diketahui Qlar dari luar: Custom API, tool MCP, agent lain dan agent A2A, serta tool plugin dengan efek tidak diketahui. Sebelum ditinjau, tool ini diblokir dalam simulasi. Masing-masing punya switch Run live. |
| Reads data | Chip: Default: Live. Tool plugin yang hanya membaca data, seperti SQL DB Reader, Dynamic Table, dan Public Documents. Tool ini berjalan live kecuali Anda mematikan Run live, yang memblokirnya. |
| Not set on this page | Tanpa chip default. Tool yang tidak pernah diubah halaman ini. Setiap tool menampilkan apa yang dilakukannya: Simulated success (tool yang menulis data, seperti Conversational Form, Reminder, dan eskalasi, yang disimulasikan) atau Always runs (tool bawaan dan internal yang hanya membaca). Card ini diakhiri catatan "To run a Simulated success tool for real, open the scenario and use Allow live… in its Agent Tools panel. Real writes are always a per-scenario choice." Allow live… ada di panel Agent Tools pada formulir skenario. |
| No longer on this agent | Tanpa chip default. Terbuka secara default. Hanya tampil saat ada sisa pengaturan untuk tool yang tidak lagi dimiliki agent. Lihat No Longer on This Agent. |
Tool yang tidak dapat diklasifikasikan Qlar tidak terdaftar di grup mana pun.
Hitungan Grup dan Aksi Massal
| Baris hitungan | Di samping judul setiap grup, misalnya "12 tools · 3 not reviewed · 1 unsaved". Bagian "not reviewed" dan "unsaved" hanya muncul saat ada yang dihitung. |
| Judul sub-grup | Di dalam grup, tool dikelompokkan menurut sumber, misalnya Custom API · <API group>, Plugins · <plugin name>, MCP · <server name>, Other agents, A2A, dan Built-in. Di Not set on this page, judulnya adalah Simulated success dan Always runs. |
| Turn all on / Turn all off | Dua tombol pada judul sub-grup, tampil saat sub-grup punya minimal dua tool yang dapat diubah. Turn all on menyalakan Run live untuk semuanya, Turn all off mematikannya. Masing-masing nonaktif saat tidak akan mengubah apa pun. Mematikan tool yang belum ditinjau tetap dihitung sebagai perubahan, karena menandai tool itu sudah ditinjau. |
| Plugin tidak dapat dimuat | Plugin yang tool-nya tidak dapat dimuat menampilkan pengaturan tersimpannya, terkunci, dengan catatan "This plugin's tools couldn't be loaded". |
Filter
| All tools | Menampilkan semua tool. |
| Not reviewed (n) | Hanya menampilkan tool Effect unknown yang belum ditinjau siapa pun, beserta jumlahnya. |
| Unsaved (n) | Hanya menampilkan tool yang Anda ubah dan belum disimpan, beserta jumlahnya. |
| Search tools | Pencarian tidak peka huruf besar-kecil pada nama tool, deskripsi, judul sumber, dan, di Not set on this page, statusnya. |
| No tools match | Tampil saat filter dan pencarian tidak menyisakan apa pun. Selama filter atau pencarian aktif, grup tanpa hasil disembunyikan dan grup yang cocok dibuka. |
Baris Tool dan Run live
| Nama dan ikon tool | Nama tool, dengan ikon untuk jenisnya. Arahkan kursor ke deskripsi untuk membacanya utuh. |
| Chip ketersediaan | Disabled, Disabled in Draft, Disabled in Published, Draft only, atau Published only, saat tool dimatikan atau hanya ada di satu versi. |
| Not reviewed | Chip pada tool Effect unknown yang belum ditinjau siapa pun. Menyalakan atau mematikan switch-nya menandainya sudah ditinjau setelah Anda menyimpan. |
| Run live | Switch di sisi kanan. Menyala, tool berjalan sungguhan dalam simulasi saat tidak ada mock atau pengaturan skenario yang menjawab. Mati, tool diblokir. Tool di Not set on this page tidak punya switch; sebagai gantinya mereka menampilkan Simulated success atau Always runs. |
| Catatan kunci | Pada tool yang dimatikan di Draft dan Published, switch-nya terkunci dan baris menampilkan "Turned off in Draft and Published. Enable the tool to change this setting; it applies again as soon as the tool is on." |
| Peringatan | Tampil di bawah tool yang berstatus Run live dan bisa berdampak nyata: "This is a <method> call. Running it live changes real data in every simulation run." (untuk Custom API yang bukan GET), "The name suggests this tool changes data. Running it live does so in every simulation run." (untuk tool MCP), "This agent runs as a normal conversation, so its own tools also run for real: its escalations, forms and API calls are not simulated." (untuk agent lain), atau "<name> is outside Qlar. Whatever it does with the request happens for real." (untuk agent A2A). |
| Baris yang berubah | Baris yang Anda ubah dan belum disimpan diberi tanda, dan dihitung di Unsaved. |
No Longer on This Agent
Card untuk pengaturan milik tool yang tidak lagi dimiliki agent, sehingga kini tidak berfungsi. Card ini dibuka dengan: "These settings belong to tools this agent no longer has, so they do nothing now. Move each one to the tool that replaced it, or remove it. A Custom API or other agent renamed on its own page is carried over automatically, and a tool that is only disabled is never listed here."
| Judul grup dan alasan | Judul menurut sumber, misalnya MCP · <server> (removed server), Plugins · <plugin> (removed plugin), Custom API, Other agents, A2A, atau Other tools, dengan alasannya: "The <server> server was removed and added again, so its tools are new to Qlar." (atau plugin), atau "Deleted from the agent." |
| Baris pengaturan | Nama tool lama dan sebuah chip, Was Live atau Was Blocked. |
| Move to… | Dropdown berisi tool saat ini yang dapat menerima pengaturan, lalu Move. Tool dengan nama yang sama ditandai "· same name". Pengaturan lama hilang dari daftar dan tool yang dipilih mengambil nilainya. |
| Move all to… | Pada grup MCP atau plugin: dropdown berisi server atau instance plugin saat ini, lalu Move. Setiap pengaturan pindah ke tool dengan nama yang sama di sana. Satu baris status menjelaskan hasilnya, misalnya "3 settings moved to Calendar. 1 stayed: 1 with no tool of that name on Calendar." Sebuah pengaturan tetap di tempatnya saat tidak ada tool bernama sama, saat tool itu sudah punya pengaturan sendiri, atau saat tool itu tidak dapat diatur di halaman ini. |
| Remove | Mengeluarkan pengaturan lama dari policy. |
Cancel di footer mengembalikan setiap pengaturan yang dipindahkan dan dihapus.
Footer Perubahan Belum Disimpan
Bar di bagian bawah halaman.
| Teks status | "No unsaved changes", atau "n unsaved changes" setelah Anda mengubah sesuatu. |
| Cancel | Membuang perubahan Anda dan mengembalikan pengaturan tersimpan. Nonaktif saat tidak ada perubahan. |
| Save | Membuka konfirmasi. Nonaktif saat tidak ada perubahan, atau saat daftar tool tidak dapat dimuat. |
Konfirmasi Simpan
Mengklik Save membuka dialog berjudul "Save n changes to the tool policy?". Dialog ini berbunyi: "Every scenario of <agent> uses these settings for calls that no mock answers, starting with the next run. Runs already queued keep the old settings."
Di bawah kalimat itu ada daftar setiap perubahan, satu baris per tool, misalnya "get_report: Not reviewed (Blocked) → Live", "list_events: Blocked → Live, moved from list_events on the removed server" atau "getLabResults: old setting removed (no longer on this agent)". Saat ada tool yang menjadi live, dialog menambahkan: "Tools set to Live call the real system with real credentials in every simulation run, so what they do is not simulated." dan, saat salah satunya adalah agent lain, "Other agents and A2A agents run as normal conversations, so everything they do, including their own tools, happens for real."
Tombolnya adalah Save policy dan Cancel.
Setelah Menyimpan
| Success | "Tool policy saved — The next simulation run of this agent uses the new settings." |
| Conflict | "The policy changed since you opened it. Reload it?" saat orang lain menyimpan lebih dulu. Reload memuat versi mereka dan membuang perubahan Anda yang belum disimpan. |
| Failure | "Failed to save the tool policy." atau alasan yang diberikan server. Reload yang gagal berbunyi "Failed to reload the tool policy." |
Panduan terkait: Tool Policy, Memilih Tool yang Berjalan Live