DatomsDBS Agent 自然语言使用指南

基于实际测试结果的最佳实践指南

🎯 支持的查询类型

✅ 数据资产管理

# 列出所有数据资产
curl -X POST http://localhost:9000/api/agent/v1/interact \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api_92d5f2e87b4a6c3d1e9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f" \
  -d '{
    "userId": "test-user",
    "sessionId": "session-001",
    "type": "natural_language",
    "query": "显示我的所有数据资产"
  }'

# 查找特定类型的数据资产
curl -X POST http://localhost:9000/api/agent/v1/interact \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api_92d5f2e87b4a6c3d1e9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f" \
  -d '{
    "userId": "test-user",
    "sessionId": "session-001",
    "type": "natural_language",
    "query": "显示包含'Acme'的数据资产"
  }'

✅ 数据源管理

# 列出数据源
curl -X POST http://localhost:9000/api/agent/v1/interact \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api_92d5f2e87b4a6c3d1e9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f" \
  -d '{
    "userId": "test-user",
    "sessionId": "session-001",
    "type": "natural_language",
    "query": "列出我的数据源"
  }'

# 查找特定类型的数据源
curl -X POST http://localhost:9000/api/agent/v1/interact \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api_92d5f2e87b4a6c3d1e9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f" \
  -d '{
    "userId": "test-user",
    "sessionId": "session-001",
    "type": "natural_language",
    "query": "显示所有MySQL数据源"
  }'

✅ 数据查询 (需要适当权限)

# 查询数据资产
curl -X POST http://localhost:9000/api/agent/v1/interact \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api_92d5f2e87b4a6c3d1e9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f" \
  -d '{
    "userId": "test-user",
    "sessionId": "session-001",
    "type": "natural_language",
    "query": "查询Acme客户主数据中的所有实体"
  }'

💡 推荐的查询表达方式

中文查询示例

• ✅ "显示我的数据资产"
• ✅ "列出所有数据源"
• ✅ "查询客户数据"
• ✅ "获取产品信息"

English查询示例

• ✅ "List my data assets"
• ✅ "Show all data sources"
• ✅ "Query customer data"
• ✅ "Get product information"

⚠️ 不支持的查询类型

❌ 普通对话

// 这类查询会被正确拒绝
"Hello, how are you?" → "cannot_handle"
"What's the weather?" → "cannot_handle"
"Tell me a joke" → "cannot_handle"

❌ 系统管理操作

• 创建/删除数据库
• 用户管理
• 系统配置

📈 性能预期

基于测试结果：

• Agent处理: < 5ms
• LLM理解: 3-7秒
• 总响应时间: 通常 < 10秒
• 成功率: 对于数据操作查询 > 95%

🔐 权限注意事项

某些操作需要特定权限：

• 查询数据资产内容
• 获取数据源详情
• 修改数据

如遇到权限错误，请联系管理员配置相应权限。

🎯 最佳实践

1. 使用明确的动词: "显示"、"列出"、"查询"、"获取"
2. 指定目标对象: "数据资产"、"数据源"、"客户数据"
3. 包含过滤条件: "包含'Acme'"、"MySQL类型"
4. 保持会话一致: 使用相同sessionId进行上下文查询

📊 实际数据资产示例

根据测试结果，当前系统包含：

• permissionsDB - 权限管理数据库
• Acme 客户主数据 (CSV) - CSV客户数据
• Acme 产品目录 (JSON) - JSON产品数据
• Acme Q1营销报告 (PDF) - PDF报告文档
• 产品图片 SKU001/002 - 图片资产
• 等共19个数据资产

🔄 会话示例

连续查询示例：

# 第一次查询
"显示我的数据资产" 

# 基于结果的后续查询
"获取Acme客户主数据的详细信息"

# 进一步查询
"查询其中的客户记录"