internal-database

name	internal-database
description	Discover and operate database tables the current user can access.
when_to_use	Use this skill when an assistant answer needs to inspect, query, insert, update, or delete structured database records.
provider_type	builtin
provider_id	database
runtime_type	tool
tools	["list_accessible_databases","list_database_tables","describe_database_table","query_table_records","insert_table_records","update_table_records","delete_table_records"]
max_calls_per_turn	40
timeout_seconds	30
tool_governance	{"list_accessible_databases":{"tool_id":"database.list_accessible","skill_id":"internal-database","domain":"database","effect":"read","asset_type":"database","risk_level":"low","requires_asset_resolution":false,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["database:read"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"list_database_tables":{"tool_id":"database.list_tables","skill_id":"internal-database","domain":"database","effect":"read","asset_type":"database","risk_level":"low","requires_asset_resolution":true,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["database:read"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"describe_database_table":{"tool_id":"database.describe_table","skill_id":"internal-database","domain":"database","effect":"read","asset_type":"database_table","risk_level":"low","requires_asset_resolution":true,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["database:read"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"query_table_records":{"tool_id":"database.query_records","skill_id":"internal-database","domain":"database","effect":"read","asset_type":"database_table","risk_level":"low","requires_asset_resolution":true,"reversible":false,"bulk_sensitive":false,"external_side_effect":false,"permission_scopes":["database:read"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":false},"insert_table_records":{"tool_id":"database.insert_records","skill_id":"internal-database","domain":"database","effect":"create","asset_type":"database_table","risk_level":"medium","requires_asset_resolution":true,"reversible":false,"bulk_sensitive":true,"external_side_effect":false,"permission_scopes":["database:write"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":true},"update_table_records":{"tool_id":"database.update_records","skill_id":"internal-database","domain":"database","effect":"update","asset_type":"database_table","risk_level":"medium","requires_asset_resolution":true,"reversible":false,"bulk_sensitive":true,"external_side_effect":false,"permission_scopes":["database:write"],"default_approval_policy":"auto_by_permission_tier","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":true},"delete_table_records":{"tool_id":"database.delete_records","skill_id":"internal-database","domain":"database","effect":"delete","asset_type":"database_table","risk_level":"high","requires_asset_resolution":true,"reversible":false,"bulk_sensitive":true,"external_side_effect":false,"permission_scopes":["database:write"],"default_approval_policy":"always_ask","allowed_permission_tiers":["basic","advanced","full"],"audit_required":true,"idempotency_required":true}}
display	{"icon":"database","category":"data_analysis","scenarios":["data_insights","business_operations"],"label":{"en_US":"Internal Database","zh_Hans":"内部数据库"},"description":{"en_US":"Designed for workspace questions or actions that depend on structured business data; finds accessible databases, inspects tables, and queries or updates records.","zh_Hans":"适用于需要使用结构化业务数据的问答或操作，可查找有权限访问的数据库、查看表结构并查询或更新记录。"},"when_to_use":{"en_US":"Use when the assistant needs facts or changes from workspace database tables.","zh_Hans":"当助手需要从工作区数据库表读取事实或写入变更时使用。"},"tags":{"en_US":["Database","Records"],"zh_Hans":["数据库","记录"]}}
supported_callers	["aichat"]

Internal Database Skill

Use this skill to work with database tables the current user can access.

Workflow

1. Call list_accessible_databases before using a database ID.
2. Call list_database_tables before using a table ID.
3. Call describe_database_table before writing records so field names and types are known.
4. Use only database IDs and table IDs returned by these tools.
5. For record changes, call only the structured insert, update, or delete tools. Do not generate or ask to run SQL.

Tool Usage

Read operations require database view and AI query permissions. Write operations require AI query permission plus database data edit or manage permission.