version: "1.0.1" 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.