agent-management

name	agent-management
description	Manage Agent assets and governed Agent bindings from the contextual console assistant when the user has the required workspace permissions.
when_to_use	Use this hidden skill when the user asks the assistant to create an Agent, edit Agent details, delete an Agent, inspect Agent draft config, query available Agent runtime models, update supported draft config fields, or replace Agent skill/knowledge/database/workflow bindings.
provider_type	builtin
provider_id	agent_management
runtime_type	tool
tools	["list_agents","get_agent","create_agent","update_agent_identity","delete_agent","delete_agents","get_agent_config","update_agent_config","replace_agent_memory_slots","list_agent_skill_candidates","list_agent_knowledge_candidates","list_agent_database_candidates","list_agent_database_tables","list_agent_workflow_binding_candidates","list_available_models"]
max_calls_per_turn	14
timeout_seconds	90
tool_governance	{"list_agents":{"tool_id":"agent.list","skill_id":"agent-management","domain":"agents","effect":"read","asset_type":"agent","risk_level":"low","requires_asset_resolution":false,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage"],"default_approval_policy":"never_ask","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"get_agent":{"tool_id":"agent.get","skill_id":"agent-management","domain":"agents","effect":"read","asset_type":"agent","risk_level":"low","requires_asset_resolution":false,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage"],"default_approval_policy":"never_ask","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"get_agent_config":{"tool_id":"agent.get_config","skill_id":"agent-management","domain":"agents","effect":"read","asset_type":"agent","risk_level":"low","requires_asset_resolution":false,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage"],"default_approval_policy":"never_ask","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"create_agent":{"tool_id":"agent.create","skill_id":"agent-management","domain":"agents","effect":"create","asset_type":"agent","risk_level":"medium","requires_asset_resolution":false,"reversible":true,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"update_agent_identity":{"tool_id":"agent.update_identity","skill_id":"agent-management","domain":"agents","effect":"update","asset_type":"agent","risk_level":"medium","requires_asset_resolution":true,"reversible":true,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"update_agent_config":{"tool_id":"agent.update_config","skill_id":"agent-management","domain":"agents","effect":"update","asset_type":"agent","risk_level":"medium","requires_asset_resolution":true,"reversible":true,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"replace_agent_memory_slots":{"tool_id":"agent.replace_memory_slots","skill_id":"agent-management","domain":"agents","effect":"update","asset_type":"agent","risk_level":"medium","requires_asset_resolution":true,"reversible":true,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"list_agent_knowledge_candidates":{"tool_id":"agent.list_knowledge_candidates","skill_id":"agent-management","domain":"agents","effect":"read","asset_type":"knowledge_base","risk_level":"low","requires_asset_resolution":false,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage","knowledge:read"],"default_approval_policy":"never_ask","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"list_agent_skill_candidates":{"tool_id":"agent.list_skill_candidates","skill_id":"agent-management","domain":"agents","effect":"read","asset_type":"agent_skill","risk_level":"low","requires_asset_resolution":false,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage"],"default_approval_policy":"never_ask","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"list_agent_database_candidates":{"tool_id":"agent.list_database_candidates","skill_id":"agent-management","domain":"agents","effect":"read","asset_type":"database_table","risk_level":"low","requires_asset_resolution":false,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage","database:read"],"default_approval_policy":"never_ask","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"list_agent_database_tables":{"tool_id":"agent.list_database_tables","skill_id":"agent-management","domain":"agents","effect":"read","asset_type":"database_table","risk_level":"low","requires_asset_resolution":false,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["agent:manage","database:read"],"default_approval_policy":"never_ask","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"list_agent_workflow_binding_candidates":{"tool_id":"agent.list_workflow_binding_candidates","skill_id":"agent-management","domain":"agents","effect":"read","asset_type":"workflow","risk_level":"low","requires_asset_resolution":false,"reversible":"[Truncated]","bulk_sensitive":"[Truncated]","external_side_effect":"[Truncated]","permission_scopes":"[Truncated]","default_approval_policy":"[Truncated]","allowed_permission_tiers":"[Truncated]","audit_required":"[Truncated]","idempotency_required":"[Truncated]"},"list_available_models":"[Truncated]","delete_agent":"[Truncated]","delete_agents":"[Truncated]"}
display	[Truncated]
supported_callers	[Truncated]

Agent Management Skill

Use this skill for governed Agent asset operations in the contextual console assistant. It is intentionally separate from Agent runtime skills: this skill changes Agent assets in the console; it does not invoke Agents, publish Agents, roll back versions, expose API keys, or run bound workflows.

Workflow

1. Treat backend-backed current page visible_agents as authoritative resolved targets for list-page ordinal references. Agent detail pages expose only current_agent; they do not define a visible Agent list.
2. Use list_agents when no fresh backend-backed list context is available, when a mutation made that list stale, or when the user asks to search beyond the current page query.
3. When resolving a named Agent for mutation, do at most one exact-name list_agents search and, if needed, one broader workspace list/check. If neither proves a target, stop without requesting governance approval or deleting/modifying anything, and report the missing target with the evidence you checked. Do not keep retrying with near-duplicate keywords.
4. Use get_agent when the user asks about one Agent's basic information and visible/page context does not already answer it.
5. Use create_agent when the user asks to create a new Agent. Create only AGENT type drafts in the current workspace unless a target workspace is explicitly available in context. This skill does not create, edit, delete, or configure Workflow assets; Workflows live under /console/workflows and need a separate Workflow-specific capability.
6. Use update_agent_identity for Agent name, description, or icon changes. update_agent_config does not change Agent name, description, icon text, or icon background. When one user turn asks to change both identity fields and runtime/draft config fields, plan and execute both tools: update_agent_identity for identity fields and update_agent_config for config fields. Do not finish after only one of them unless the other tool failed or the user no longer wants that part.
7. Use get_agent_config before changing draft runtime configuration if the current config is not already known from authoritative tool evidence in this execution. For every system-prompt change, first obtain the complete current system_prompt; page context or a remembered description is not sufficient. The update is a full replacement, so preserve all unrelated current prompt content exactly.
8. For read-only current configuration checks, get_agent_config is enough to answer the Agent's name, description, icon, model/provider, prompt, memory/file-upload settings, and currently bound Skill/knowledge/database/workflow counts. Do not call candidate-list tools or table-list tools just to inspect existing bindings or counts; call them only when the user asks what resources are available/bindable/selectable, or when a bind/unbind/replace operation needs exact candidate IDs. Do not call ; current page context is injected by the runtime and is not a skill tool.