Zdieľať cez


Používajte ai.generate_response s pandami

Funkcia ai.generate_response využíva generatívnu umelú inteligenciu na generovanie vlastných textových odpovedí, ktoré sú založené na vašich vlastných pokynoch, s jedným riadkom kódu.

Poznámka

Overview

Funkcia ai.generate_response môže rozšíriť triedu pandas DataFrame a triedu pandas Series .

Ak chcete generovať vlastné textové odpovede riadok po riadku, môžete túto funkciu zavolať buď v sérii pandas, alebo v celom údajovom rámci pandas.

Ak voláte funkciu v celom údajovom rámci pandas, výzva môže byť doslovným reťazcom a funkcia pri generovaní odpovedí zohľadňuje všetky stĺpce údajového rámca. Výzva môže byť aj formátovacím reťazcom, kde funkcia berie do úvahy iba tie hodnoty stĺpcov, ktoré sa v výzve zobrazujú medzi zloženými zátvorkami.

Funkcia vráti pandas series, ktorá obsahuje vlastné textové odpovede pre každý riadok vstupu. Textové odpovede môžu byť uložené v novom stĺpci údajového rámca.

Tip

Naučte sa, ako vytvárať efektívnejšie výzvy, aby ste získali kvalitnejšie odpovede, podľa tipov OpenAI pre gpt-4.1.

Syntax

df["response"] = df.ai.generate_response(prompt="Instructions for a custom response based on all column values")

Parametre

Name Popis
prompt
Povinné
Reťazec, ktorý obsahuje pokyny na použitie na vstupné textové hodnoty pre vlastné odpovede.
is_prompt_template
Voliteľné
Booleovská hodnota, ktorá označuje, či je výzva reťazcom formátu alebo reťazcom literálu. Ak je tento parameter nastavený na True, funkcia zhodnotí iba konkrétne hodnoty riadkov z každého názvu stĺpca, ktorý sa zobrazí v reťazci formátu. V tomto prípade sa tieto názvy stĺpcov musia zobrazovať medzi zloženými zátvoriekmi a ostatné stĺpce sa ignorujú. Ak je tento parameter nastavený na predvolenú hodnotu False, funkcia posúdi všetky hodnoty stĺpcov ako kontext pre každý vstupný riadok.
response_format
Voliteľné
Slovník, ktorý špecifikuje očakávanú štruktúru odpovede modelu. Pole type môže byť nastavené na "text" pre voľný text, "json_object" na zabezpečenie platnosti JSON objektu alebo vlastnú JSON schému na vynútenie špecifickej odpovednej štruktúry. Ak tento parameter nie je poskytnutý, odpoveď sa vráti ako čistý text.

Vrátené hodnoty

Funkcia vráti údajový rámec pandas , ktorý obsahuje vlastné textové odpovede na výzvu pre každý riadok vstupného textu.

Príklad

# This code uses AI. Always review output for mistakes.

df = pd.DataFrame([
        ("Scarves"),
        ("Snow pants"),
        ("Ski goggles")
    ], columns=["product"])

df["response"] = df.ai.generate_response("Write a short, punchy email subject line for a winter sale.")
display(df)

Táto príkladová bunka kódu poskytuje nasledujúci výstup:

Snímka obrazovky zobrazujúca údajový rámec so stĺpcami

Príklad formátu odpovede

Nasledujúci príklad ukazuje, ako použiť response_format parameter na určenie rôznych formátov odpovedí, vrátane obyčajného textu, JSON objektu a vlastnej JSON schémy.

# This code uses AI. Always review output for mistakes.

df = pd.DataFrame([
        ("Alex Rivera is a 24-year-old soccer midfielder from Barcelona who scored 12 goals last season."),
        ("Jordan Smith, a 29-year-old basketball guard from Chicago, averaged 22 points per game."),
        ("William O'Connor is a 22-year-old tennis player from Dublin who won 3 ATP titles this year.")
    ], columns=["bio"])

# response_format : text
df["card_text"] = df.ai.generate_response(
    "Create a player card with the player's details and a motivational quote", 
    response_format={"type": "text"}
)

# response_format : json object
df["card_json_object"] = df.ai.generate_response(
    "Create a player card with the player's details and a motivational quote in JSON", 
    response_format={"type": "json_object"} # Requires "json" in the prompt
)

# response_format : specified json schema
df["card_json_schema"] = df.ai.generate_response(
    "Create a player card with the player's details and a motivational quote", 
    response_format={
        "type": "json_schema",
            "json_schema": {
            "name": "player_card_schema",
            "strict": True,
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "age": {"type": "integer"},
                    "sport": {"type": "string"},
                    "position": {"type": "string"},
                    "hometown": {"type": "string"},
                    "stats": {"type": "string", "description": "Key performance metrics or achievements"},
                    "motivational_quote": {"type": "string"}
                },
                "required": ["name", "age", "sport", "position", "hometown", "stats", "motivational_quote"],
                "additionalProperties": False,
            },
        },
    },
)

display(df)

Táto príkladová bunka kódu poskytuje nasledujúci výstup:

Snímka obrazovky zobrazujúca dátový rámec s 'bio' stĺpcom a novým stĺpcom pre každý špecifikovaný formát s príslušným formátovaným výstupom.