Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Extração e Classificação de Entidades

Aula 11 de 12 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Principais casos de uso
  2. Extração de entidades nomeadas
  3. Classificação de conteúdo
  4. Classificação multi-rótulo
  5. Extração de dados tabulares
  6. Análise de sentimento granular
  7. Pontos-chave

Principais casos de uso

As saídas estruturadas destacam-se em duas categorias de tarefas: extração de informação de texto não estruturado e classificação de conteúdo. Estes dois casos de uso são centrais para a maioria das aplicações de IA empresariais.

Extração de entidades nomeadas

A extração de entidades envolve identificar e categorizar elementos-chave num texto: pessoas, empresas, localizações, datas, valores monetários, entre outros.

from pydantic import BaseModel
from typing import Literal

class Entite(BaseModel):
    texte: str
    type: Literal[
        "person", "company", "location",
        "date", "amount", "product"
    ]
    contexte: str

class ExtractionEntites(BaseModel):
    entites: list[Entite]
    nombre_total: int
    langue_detectee: str

response, parsed = client.chat.parse(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": """Extract all entities from this text:

        On March 15, 2026, Mistral AI raised €600 million
        from General Catalyst. Arthur Mensch, the CEO based in
        Paris, plans to launch Mistral Large 3 by June."""
    }],
    response_format=ExtractionEntites
)

for e in parsed.entites:
    print(f"[{e.type}] {e.texte} — {e.contexte}")

Classificação de conteúdo

A classificação atribui categorias predefinidas ao conteúdo. As saídas estruturadas garantem que o modelo devolve apenas categorias válidas.

class ClassificationEmail(BaseModel):
    categorie: Literal[
        "sales", "support", "billing",
        "partnership", "application", "spam", "other"
    ]
    sous_categorie: str
    priorite: Literal["low", "medium", "high", "urgent"]
    sentiment: Literal["positive", "neutral", "negative"]
    action_requise: bool
    resume: str

response, parsed = client.chat.parse(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": """Classify this email:

        Subject: Urgent billing issue

        Hello, our latest invoice #2847 contains an error.
        The amount shown is €3,500 instead of the agreed €2,800.
        Please correct this quickly."""
    }],
    response_format=ClassificationEmail
)

print(f"Category: {parsed.categorie}")      # "billing"
print(f"Priority: {parsed.priorite}")        # "high"
print(f"Action required: {parsed.action_requise}")  # True

Classificação multi-rótulo

Quando o conteúdo pode pertencer a várias categorias:

class ClassificationArticle(BaseModel):
    titre: str
    themes: list[str]
    audience_cible: list[Literal[
        "developers", "managers", "data_scientists",
        "designers", "executives", "general_public"
    ]]
    niveau_technique: Literal["beginner", "intermediate", "advanced"]
    mots_cles_seo: list[str]
    temps_lecture_minutes: int

Extração de dados tabulares

Transforme texto em dados estruturados acionáveis:

class LigneCommande(BaseModel):
    reference: str
    designation: str
    quantite: int
    prix_unitaire: float
    montant_total: float

class BonCommande(BaseModel):
    numero: str
    date: str
    fournisseur: str
    lignes: list[LigneCommande]
    montant_ht: float
    tva: float
    montant_ttc: float

response, parsed = client.chat.parse(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": """Extract data from this purchase order:

        PO-2026-0847 dated 03/28/2026 — Supplier: TechParts SAS

        REF-001 | USB-C Cable 2m | x50 | €3.20
        REF-002 | HDMI Adapter | x20 | €12.50
        REF-003 | 4-port USB Hub | x10 | €24.90"""
    }],
    response_format=BonCommande
)

Análise de sentimento granular

Para além de um simples positivo/negativo, estruture uma análise completa:

class AspectSentiment(BaseModel):
    aspect: str
    sentiment: Literal["very_positive", "positive", "neutral", "negative", "very_negative"]
    mention: str

class AnalyseAvis(BaseModel):
    note_globale: float
    sentiment_global: str
    aspects: list[AspectSentiment]
    points_forts: list[str]
    points_faibles: list[str]
    recommande: bool

Pontos-chave

  • A extração de entidades identifica pessoas, localizações, datas e valores em texto livre
  • A classificação impõe categorias predefinidas utilizando Literal e enum
  • A classificação multi-rótulo utiliza listas de Literal
  • A extração tabular transforma texto não estruturado em dados acionáveis
  • A análise de sentimento pode ser granular com aspetos individuais
  • Todos estes padrões funcionam com parse() ou response_format