Hierarchical Taxonomy Classification

from mixpeek import Mixpeek

client = Mixpeek(api_key="your-api-key")

# Define taxonomy structure
taxonomy = client.taxonomies.create(
    taxonomy_name="content_classification",
    hierarchy={
        "safe_content": {
            "educational": ["tutorial", "documentary"],
            "entertainment": ["comedy", "music"]
        },
        "review_required": {
            "ambiguous": ["political", "news"]
        }
    }
)

# Classify content
result = client.collections.classify(
    collection_id="my-collection",
    taxonomy_id=taxonomy.id,
    confidence_threshold=0.75
)

# Filter by taxonomy in retriever
results = client.retrievers.execute(
    retriever_id="filtered-retriever",
    inputs={
        "query_text": "educational videos",
        "taxonomy_path": "safe_content.educational"
    }
)