Delen via


Tekst vertalen met de functie ai.translate

De functie ai.translate maakt gebruik van Generatieve AI om invoertekst te vertalen naar een nieuwe taal van uw keuze, allemaal met één regel code.

AI-functies versterken data engineering door de kracht van Fabric's ingebouwde grote taalmodellen binnen handbereik te brengen. Ga naar dit overzichtsartikelvoor meer informatie.

Belangrijk

Deze functie bevindt zich in preview-, voor gebruik in de runtime van Fabric 1.3 en hoger.

  • Bekijk de vereisten in dit overzichtsartikel , inclusief de bibliotheekinstallaties die tijdelijk vereist zijn voor het gebruik van AI-functies.
  • AI-functies worden momenteel aangedreven door het gpt-3.5-turbo (0125) model. Ga naar dit artikelvoor meer informatie over facturerings- en verbruikstarieven.
  • Hoewel het onderliggende model verschillende talen kan verwerken, zijn de meeste AI-functies geoptimaliseerd voor gebruik op Engelse teksten.
  • Tijdens de eerste implementatie van AI-functies zijn gebruikers tijdelijk beperkt tot 1000 aanvragen per minuut met het ingebouwde AI-eindpunt van Fabric.

Tip

De ai.translate functie is getest met 10 talen: Tsjechisch, Engels, Finse, Frans, Duits, Grieks, Italiaans, Pools, Spaansen Zweeds. Uw resultaten met andere talen kunnen variëren.

ai.translate gebruiken met pandas

De functie ai.translate breidt de pandas Series klasse uit. Roep de functie aan op een pandas DataFrame tekstkolom om elke invoerrij te vertalen in een doeltaal van uw keuze.

De functie retourneert een pandas-serie die vertalingen bevat, die u kunt opslaan in een nieuwe DataFrame-kolom.

Syntaxis

df["translations"] = df["text"].ai.translate("target_language")

Parameters

naam beschrijving
to_lang
Vereist
Een tekenreeks die de doeltaal voor tekstvertalingen vertegenwoordigt.

Retouren

Een pandas-serie die vertalingen bevat voor elke rij invoertekst. Als de invoertekst nullis, wordt het resultaat null.

Voorbeeld

# This code uses AI. Always review output for mistakes. 
# Read terms: https://azure.microsoft.com/support/legal/preview-supplemental-terms/

df = pd.DataFrame([
        "Hello! How are you doing today?", 
        "Tell me what you'd like to know, and I'll do my best to help.", 
        "The only thing we have to fear is fear itself."
    ], columns=["text"])

df["translations"] = df["text"].ai.translate("spanish")
display(df)

ai.translate gebruiken met PySpark

De functie ai.translate is ook beschikbaar voor Spark DataFrames. U moet een bestaande naam voor de invoerkolom opgeven als parameter, samen met een doeltaal.

De functie retourneert een nieuw DataFrame, met vertalingen voor elke invoertekstrij die is opgeslagen in een uitvoerkolom.

Syntaxis

df.ai.translate(to_lang="spanish", input_col="text", output_col="translations")

Parameters

naam Beschrijving
to_lang
Vereist
Een tekenreeks die de doeltaal voor tekstvertalingen vertegenwoordigt.
input_col
Vereist
Een tekenreeks die de naam van een bestaande kolom bevat met invoertekstwaarden die moeten worden vertaald.
output_col
Facultatief
Een tekenreeks die de naam bevat van een nieuwe kolom waarin vertalingen voor elke invoertekstrij worden opgeslagen. Als deze parameter niet is ingesteld, wordt er een standaardnaam gegenereerd voor de uitvoerkolom.
error_col
Facultatief
Een tekenreeks die de naam bevat van een nieuwe kolom waarin openAI-fouten worden opgeslagen die het gevolg zijn van het verwerken van elke invoertekstrij. Als deze parameter niet is ingesteld, wordt er een standaardnaam gegenereerd voor de foutkolom. Als een invoerrij geen fouten bevat, wordt de waarde in deze kolom null.

Retour

Een Spark DataFrame met een nieuwe kolom die vertalingen bevat voor de tekst in de invoer kolomrij. Als de invoertekst nullis, wordt het resultaat null.

Voorbeeld

# This code uses AI. Always review output for mistakes. 
# Read terms: https://azure.microsoft.com/support/legal/preview-supplemental-terms/

df = spark.createDataFrame([
        ("Hello! How are you doing today?",),
        ("Tell me what you'd like to know, and I'll do my best to help.",),
        ("The only thing we have to fear is fear itself.",),
    ], ["text"])

translations = df.ai.translate(to_lang="spanish", input_col="text", output_col="translations")
display(translations)