Tool Policy

Buka di CMS

Halaman 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, halaman menampilkan No Tools To Set dengan "This agent has no tools that can be set here.", tanpa filter dan tanpa bar simpan.

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 MocksMock set yang terpasang di step yang melakukan panggilan.
Scenario MocksMock set yang terpasang di seluruh skenario.
Scenario's Allow LivePengaturan Allow Live skenario untuk tool tersebut, yang diatur di panel tool pada form skenario.
This PolicyPengaturan di halaman ini. Chip-nya disorot.
Built-in DefaultApa 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."

Dua chip mock mewakili satu pencarian atas semua mock set yang terpasang. Qlar lebih dulu memeriksa case dari semua set berurutan, step set dari atas ke bawah lalu scenario set dari atas ke bawah, dan case pertama yang cocok yang menjawab. Jika tidak ada yang cocok, set pertama yang Otherwise-nya menjawab secara default yang merespons. Hanya ketika setiap set meneruskan, atau tidak ada set yang me-mock tool itu, chip berikutnya berlaku.

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. Tool tanpa pengaturan tersimpan mengikuti default grupnya, dan switch Run Live-nya menunjukkan default itu.

Effect unknownChip: 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. Tool ini diblokir dalam simulasi sampai Anda menyalakan Run Live. Masing-masing punya switch Run Live.
Reads dataChip: Default: Live. Tool plugin yang hanya membaca data, seperti SQL DB Reader, Dynamic Table, Public Documents, dan recall pada plugin memori. Tool ini berjalan live kecuali Anda mematikan Run Live, yang memblokirnya.
Not set on this pageTanpa 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, save, forget, dan consent pada plugin memori, serta eskalasi, yang disimulasikan) atau Always runs (tool bawaan dan internal yang hanya membaca). Di bawah judul Simulated Success, sebuah catatan berbunyi "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." Di bawah Always Runs, sebuah catatan menyebut bahwa tool ini hanya membaca data atau merupakan bagian dari cara kerja agent itu sendiri, sehingga simulasi selalu menjalankannya sungguhan dan halaman ini tidak punya pengaturan untuknya. Allow Live… ada di panel yang dibuka oleh Review Tools pada formulir skenario.
No longer on this agentTanpa 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 hitunganDi samping judul setiap grup, misalnya "12 tools · 1 unsaved". Bagian "unsaved" hanya muncul saat ada yang diubah di grup itu.
Judul sub-grupDi 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 OffDua 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.
Plugin tidak dapat dimuatPlugin yang tool-nya tidak dapat dimuat menampilkan pengaturan tersimpannya, terkunci, dengan catatan "This plugin's tools couldn't be loaded".

Filter

All ToolsMenampilkan semua tool.
Unsaved (n)Hanya menampilkan tool yang Anda ubah dan belum disimpan, beserta jumlahnya. Saat tidak ada yang diubah, tampil No Unsaved Changes dengan petunjuk untuk menyalakan atau mematikan switch Run Live.
Search toolsPencarian tidak peka huruf besar-kecil pada nama tool, deskripsi, judul sumber, dan, di Not set on this page, statusnya.
No Tools FoundTampil saat pencarian tidak menyisakan apa pun, dengan petunjuk untuk mencoba pencarian lain. Selama filter atau pencarian aktif, grup tanpa hasil disembunyikan dan grup yang cocok dibuka.

Baris Tool dan Run Live

Nama dan ikon toolNama tool, dengan ikon untuk jenisnya. Deskripsi sebuah Custom API diawali metode HTTP-nya. Arahkan kursor ke deskripsi untuk membacanya utuh.
Chip ketersediaanDisabled, Disabled in Draft, Disabled in Published, Draft Only, atau Published Only, saat tool dimatikan atau hanya ada di satu versi.
Catatan ketersediaanDi bawah tool yang dimatikan atau hanya ada di satu versi, satu baris menyebut versi mana yang dicakup pengaturan, misalnya "Only in Draft so far. This setting applies to Draft runs now, and to Published runs once the tool is published."
Run LiveSwitch di sisi kanan. Menyala, tool berjalan sungguhan dalam simulasi saat tidak ada mock atau pengaturan skenario yang menjawab. Mati, tool diblokir. Tool tanpa pengaturan tersimpan menampilkan default grupnya. Tool di Not set on this page tidak punya switch; sebagai gantinya mereka menampilkan Simulated success atau Always runs.
Catatan kunciPada 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."
PeringatanTampil 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 a separate agent reached over A2A. Running it live sends it the request, and whatever it does with it happens for real." (untuk agent A2A).
Baris yang berubahBaris 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 alasanJudul 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 pengaturanNama 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.
RemoveMengeluarkan pengaturan lama dari policy.

Cancel di footer mengembalikan setiap pengaturan yang dipindahkan dan dihapus.

Di sebuah hasil, panggilan yang diblokir milik tool yang masih punya pengaturan Run Live lama menampilkan catatan, "An older <tool> was set to run live. That setting no longer applies to this tool.", dengan tautan Move it in Tool Policy → ke halaman ini.

Bar di bagian bawah halaman.

Teks status"No unsaved changes", atau "n unsaved changes" setelah Anda mengubah sesuatu.
CancelMembuang perubahan Anda dan mengembalikan pengaturan tersimpan. Nonaktif saat tidak ada perubahan.
SaveMembuka 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: Default (Blocked) → Live", "list_events: Blocked → Live, moved from list_events on the removed server" atau "getLabResults: old setting removed (no longer on this agent)". Sebuah pengaturan berbunyi Live atau Blocked saat diatur, dan Default (Live) atau Default (Blocked) saat tool mengikuti default grupnya. 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

SuccessSebuah dialog berbunyi "Tool policy saved — The next simulation run of this agent uses the new settings."
ConflictSebuah dialog berbunyi "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.
FailureSebuah dialog berbunyi "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