From 256e0c40fbcfec1b106bb6bfd7ef68e09659dd16 Mon Sep 17 00:00:00 2001 From: DAVID BOAZ Date: Wed, 14 Jan 2026 08:27:51 +0200 Subject: [PATCH] fix readme Signed-off-by: DAVID BOAZ --- altk/pre_tool/toolguard/README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/altk/pre_tool/toolguard/README.md b/altk/pre_tool/toolguard/README.md index 307aff2..44097ab 100644 --- a/altk/pre_tool/toolguard/README.md +++ b/altk/pre_tool/toolguard/README.md @@ -18,6 +18,11 @@ An agent lifecycle solution for enforcing business policy adherence in agentic w Business policies (or guidelines) are normally detailed in company documents, and have traditionally been hard-coded into automatic assistant platforms. Contemporary agentic approaches take the "best-effort" strategy, where the policies are appended to the agent's system prompt, an inherently non-deterministic approach, that does not scale effectively. Here we propose a deterministic, predictable and interpretable two-phase solution for agentic policy adherence at the tool-level: guards are executed prior to function invocation and raise alerts in case a tool-related policy deem violated. This component enforces **pre‑tool activation policy constraints**, ensuring that agent decisions comply with business rules **before** modifying system state. This prevents policy violations such as unauthorized tool calls or unsafe parameter values. +### Installation +``` +uv pip install "agent-lifecycle-toolkit[toolguard]" +``` + ## ToolGuardSpecComponent This component gets a set of tools and a policy document and generated multiple ToolGuard specifications, known as `ToolGuardSpec`s. Each specification is attached to a tool, and it declares a precondition that must apply before invoking the tool. The specification has a `name`, `description`, list of `refernces` to the original policy document, a set of declerative `compliance_examples`, describing test cases that the toolGuard should allow the tool invocation, and `violation_examples`, where the toolGuard should raise an exception.