1. Core Identity & Sanity Checks

Anchoring the Artist UUID

Before any advanced analysis can be performed, your AI Agent must resolve the exact identity of the artist in Chatmu's global database. We do this to prevent the AI from confusing 'Bad Bunny' with a tribute band or a similarly named artist.

Tool: search_artist

Description: Searches for artists by name match (typo-tolerant). Returns basic information including their unique UUID.

Input Schema:

{
  "query": "Billie Eilish"
}

Output: Returns a list of candidates. The Agent will typically select the one with the highest exact match or follower count and extract the UUID.

Tool: artist_details

Description: Once the UUID is obtained, this tool extracts the artist's structural profile.

Input Schema:

{
  "uuid": "11e81bc0-..."
}

Output: Returns the artist's primary genres, country of origin, and their careerStage (e.g., Superstar, Mainstream, Developing, Long-tail), allowing the AI to adjust its analytical tone.