mcpField
E
entity-lookup

entity-lookup

github.com/lytics数据与数据库460 次安装3 周前更新
代码仓库

关于 entity-lookup

用于通过身份字段查询 Lytics 用户档案的技能，面向需要查看用户属性和分群信息的工作流。也提供实体删除操作，并区分不可逆硬删除与软删除。

主要功能

  1. 01按身份字段查询完整档案
  2. 02跨身份字段按值搜索
  3. 03查看实体的分群归属
  4. 04支持硬删除和软删除

适用场景

  1. 01按邮箱或用户 ID 查找档案
  2. 02核对用户属性及近期活动
  3. 03查看用户所属分群
  4. 04根据请求删除实体数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lytics/agent-skills --skill entity-lookup

安装后在 Claude Code 中输入/entity-lookup确认已加载。

详细介绍

实体查询

用途

按身份字段查询单个用户的个人资料。返回完整资料，包括所有字段、细分群组成员资格和元数据。

环境

需要经过身份验证的 API 访问权限。凭据解析请参阅 ../references/auth.md。

API 端点

V2 身份查询
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/identity/${TABLE}/${FIELD}/${VALUE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

示例：GET /v2/identity/user/email/[email protected]

Data API 实体查询
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/${TABLE}/${FIELD}/${VALUE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
仅按值查询实体
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/${TABLE}/${VALUE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

在所有身份字段中搜索。

实体细分群组成员资格
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/${TABLE}/segments/${FIELD}/${VALUE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
身份查询（POST）
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/identity/lookup" \
  -H "Authorization: ${LYTICS_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"field": "email", "value": "[email protected]", "table": "user"}'
删除实体
# Hard delete
curl -s -X DELETE "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/${TABLE}/${FIELD}/${VALUE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

# Soft delete
curl -s -X DELETE "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/softdelete/${TABLE}/${FIELD}/${VALUE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

常见身份字段

  • email -- 电子邮件地址
  • _uid -- Lytics 用户 ID
  • user_id -- 外部用户 ID
  • 使用 GET /v2/schema/{table}/idconfig 查看账户专属的身份字段

行为

查询（读取）

立即执行。以结构化格式显示个人资料：

  1. 身份：所有身份字段及其值
  2. 关键属性：高价值个人资料字段（姓名、位置、互动评分）
  3. 细分群组成员资格：该用户所属的细分群组
  4. 近期活动：最新事件时间戳
删除（写入）

使用确认门模式。提醒用户：

  • 硬删除不可撤销
  • 软删除可以撤销，但会影响数据处理

错误处理

  • 未找到个人资料（404）：建议尝试其他身份字段或检查拼写
  • URL 编码：如果值包含特殊字符（例如电子邮件地址中的 @），请对值进行 URL 编码
  • 多条匹配结果：如果匹配到多份个人资料，请全部列出并让用户选择

依赖项

  • 使用：../references/auth.md、../references/api-client.md、../references/confirmation-gate.md（仅用于删除）

评论

支持 Markdown