агенты: добавить поиск инструментов по каталогу

docs/admin-api.md

@@ -206,6 +206,7 @@ Auth profile хранит ссылки на secrets и способ примен
 - `POST /api/admin/workspaces/{workspace_id}/agents/{agent_id}/unpublish`
 - `POST /api/admin/workspaces/{workspace_id}/agents/{agent_id}/archive`
 - `POST /api/admin/workspaces/{workspace_id}/agents/{agent_id}/bindings`
+- `POST /api/admin/workspaces/{workspace_id}/agents/tool-search/preview`
 - `DELETE /api/admin/workspaces/{workspace_id}/agents/{agent_id}/bindings/{operation_id}`
 
 Пример создания агента:
@@ -223,6 +224,36 @@ curl https://crank.example.com/api/admin/workspaces/ws_default/agents \
   }'
 ```
 
+Привязки и политика доступа сохраняются одной атомарной операцией:
+
+```json
+{
+  "bindings": [
+    {
+      "operation_id": "op_01",
+      "operation_version": 1,
+      "tool_name": "create_invoice",
+      "tool_title": "Создать счёт",
+      "enabled": true
+    }
+  ],
+  "tool_selection_policy": {
+    "mode": "search",
+    "groups": [
+      {
+        "id": "finance",
+        "name": "Расчёты",
+        "description": "Счета, платежи и возвраты",
+        "tool_names": ["create_invoice"]
+      }
+    ],
+    "search": { "max_results": 8 }
+  }
+}
+```
+
+Старый формат тела из одного массива привязок поддерживается и сохраняет текущую политику агента. Предварительная проверка принимает те же `bindings` и `tool_selection_policy`, а также `query` и необязательный `group_ids`.
+
 ## Agent API keys
 
 - `GET /api/admin/workspaces/{workspace_id}/agents/{agent_id}/platform-api-keys`