Purpose
Interactive profile exploration that combines identity lookup, segment membership analysis, and event history browsing. Provides a comprehensive view of an individual user profile.
Environment
Requires authenticated API access. See ../references/auth.md for credential resolution.
Inputs
- Identity field and value (e.g.,
email,user@example.com) - Or: exploration query (e.g., "find a user in the high-value segment")
Exploration Flow
Step 1: Look Up Profile
Use entity-lookup skill:
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/user/${FIELD}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
Step 2: Get Segment Memberships
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/user/segments/${FIELD}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
Step 3: Present Profile Summary
Display a structured profile view:
## Profile: user@example.com
### Identity
- email: user@example.com
- user_id: 12345
- _uid: abc-def-ghi
### Key Attributes
- Name: Jane Smith
- Country: US
- City: Portland, OR
- Created: 2024-01-15
- Last Active: 2025-03-18
### Engagement
- Visit Count: 47
- Avg Visit Time: 3.2 min
- Content Affinity: Technology, Marketing
### Segment Memberships
- High Value Customers (segment)
- Email Subscribers (aspect)
- Q1 Campaign Target (list)
### Recent Events
[Summary from stream data if available]
Step 4: Interactive Exploration
After presenting the summary, the user can:
- "What segments is this user in?" -> Show detailed segment list
- "Show me their purchase history" -> Look up relevant fields
- "Compare with another user" -> Look up second profile
- "Why are they in segment X?" -> Cross-reference segment FilterQL with profile data
Finding Users
If the user doesn't have a specific identity:
- Ask what they're looking for
- Suggest searching by segment: list segment members using segment scan
- Help them identify the right profile
Error Handling
- Profile not found: Try alternative identity fields, suggest checking spelling
- Multiple identities: Show all linked identities, confirm which profile
- Large profile: Summarize key fields, offer to show full details on request
Dependencies
- Composes:
entity-lookup skill,segment-manager skill,stream-inspector skill - References:
../references/auth.md