ميزة "البحث عن معلومات أساسية" متاحة الآن على "بحث Google" مزيد من المعلومات

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

استخراج البيانات المنظَّمة باستخدام استدعاء الدوال

العرض على تكنولوجيات الذكاء الاصطناعي من Google

ستتعرّف في هذا الدليل التوجيهي على مثال لاستخراج البيانات المنظَّمة والاستعانة بواجهة برمجة تطبيقات Gemini لاستخراج قوائم الشخصيات والعلاقات والأشياء والأماكن من القصة.

ضبط إعدادات الجهاز

pip install -U -q google-generativeai

import pathlib
import textwrap

import google.generativeai as genai


from IPython.display import display
from IPython.display import Markdown

from google.api_core import retry

def to_markdown(text):
  text = text.replace('•', '  *')
  return Markdown(textwrap.indent(text, '> ', predicate=lambda _: True))

بعد حصولك على مفتاح واجهة برمجة التطبيقات، أرسِله إلى حزمة تطوير البرامج (SDK). هناك طريقتان لإجراء ذلك:

ضَع المفتاح في متغيّر البيئة GOOGLE_API_KEY (ستتولى حزمة تطوير البرامج (SDK) استلامه تلقائيًا من هناك).
تمرير المفتاح إلى genai.configure(api_key=...)

genai.configure(api_key=GOOGLE_API_KEY)

مثال المهمة

في هذا البرنامج التعليمي، ستستخرج الكيانات من القصص المكتوبة باللغة الطبيعية. على سبيل المثال، في ما يلي قصة من تأليف Gemini

new_story = False

if new_story:
  model = genai.GenerativeModel(model_name='models/gemini-1.5-pro-latest')

  response = model.generate_content("""
      Write a long story about a girl with magic backpack, her family, and at
      least one other charater. Make sure everyone has names. Don't forget to
      describe the contents of the backpack, and where everyone and everything
      starts and ends up.""", request_options={'retry': retry.Retry()})
  story = response.text
  print(response.candidates[0].citation_metadata)
else:
  story = """In the quaint town of Willow Creek, nestled amidst rolling hills and whispering willows, resided a young girl named Anya. As she stepped out of the creaky wooden door of her modest cottage, her heart skipped a beat with excitement and anticipation. Today was her first day of school, and she couldn't wait to show off her prized possession - a magical backpack.\n\nHanded down to her from her grandmother, the backpack was no ordinary satchel. Its soft, emerald-green fabric shimmered with an ethereal glow, and its leather straps held secrets that only Anya knew. Within its capacious interior lay an enchanted world, filled with wonders that would ignite her imagination and change her life forever.\n\nAnya's parents, kind-hearted Elise and wise-bearded Edward, bid her farewell with warm embraces. "Remember, my dear," whispered her mother, "use your magic wisely and for good." Her father added, "Always seek knowledge, and let the backpack be your trusted companion."\n\nWith a skip in her step, Anya set off towards the town's only schoolhouse. On her way, she passed her best friend, Samuel, a curious and adventurous boy with a mischievous grin. "Hey, Anya," he called out. "Can I see your backpack?"\n\nAnya hesitated for a moment before unzipping the flap and revealing its contents. Samuel's eyes widened in amazement as he peered inside. There, nestled amidst pencils and notebooks, were a shimmering sword, a book of ancient spells, a tiny compass that always pointed north, and a magical key that could open any lock.\n\nTogether, they marveled at the backpack's wonders, promising to keep its secrets safe. As they approached the schoolhouse, Anya noticed a group of older children huddled together, their faces etched with fear. Curiosity getting the better of her, she cautiously approached.\n\n"What's wrong?" she asked.\n\nA tall, lanky boy stepped forward. "There's a monster in the forest," he stammered. "It's been terrorizing the town, attacking animals and even people."\n\nAnya's heart sank. The town of Willow Creek was small and peaceful, and the thought of a monster brought a shiver down her spine. She knew she had to do something to protect her family and friends.\n\nWithout a moment's hesitation, Anya opened her backpack and retrieved the shimmering sword. With a determined gleam in her eye, she turned to her terrified peers. "Don't worry," she said, her voice steady. "I'll take care of it."\n\nWith Samuel close behind her, Anya ventured into the shadowy depths of the forest. The trees seemed to whisper secrets as she passed, and the undergrowth rustled with unseen creatures. As they walked deeper into the forest, the air grew heavy and the ground beneath their feet trembled.\n\nSuddenly, they came to a clearing, and there before their eyes was the monster - a massive beast with sharp teeth, glowing red eyes, and claws that could crush a human with ease. The creature roared, a thunderous sound that shook the forest to its core.\n\nFear surged through Anya, but she refused to let it consume her. She drew the sword from its sheath and charged towards the monster. The blade shimmered in the sunlight, and as it struck the beast's hide, a blinding light erupted, enveloping everything in its radiance.\n\nWhen the light faded, the monster was gone, and in its place was a pile of shattered crystals. Anya had defeated the creature with the magic of her backpack, proving that even the smallest of objects could hold the greatest of powers.\n\nAs she and Samuel returned to the town, they were greeted as heroes. The people of Willow Creek rejoiced, and the legend of Anya, the girl with the magic backpack, was passed down through generations. And so, Anya continued her adventures, using the backpack's wonders to make the world a better place, one magical step at a time."""

to_markdown(story)

في بلدة "ويلو كريك" الجذابة التي تقع وسط تلال متموّجة وأشجار صفصاف هامسة، تقيم فتاة صغيرة اسمها "أنيا". بينما خرجت من الباب الخشبي المزعج في كوخها المتواضع، كان قلبها يتخطى النبض من خلال الحماس والترقُّب. اليوم هو أول يوم لها في المدرسة، ولم تستطع الانتظار لاستعراض حيازتها الثمينة - وهي حقيبة ظهر سحرية.

وكانت حقيبة الظهر التي سلّمتها لها من جدتها، لم تكن حقيبة الظهر العادية. يتميز نسيجه الناعم باللون الأخضر الزمردي المتلألئ مع لمعان أثري، وتحمل الأحزمة الجلدية أسرارًا لا يعرفها سوى "أنيا". وفي داخلها الفسيح، يرضي عالمًا ساحرًا مليئًا بالعجائب التي ستشعل مخيلتها وتغيّر حياتها إلى الأبد.

وداعًا والدا "أنيا"، "إليز" اللطيفة و"إدوارد الحكيم"، يودِعها مع عناق حارّ. "تذكر يا عزيزتي"، هَمَسَتْ أُمَّهَا قَائِلَةً: "استخدِم سحرك بحكمة وللأبد". أضاف والدها قائلاً: "اطلبوا دائمًا الحصول على المعرفة، واجعلوا حقيبة الظهر رفيقتكم الموثوق بها".

انطلقت "أنيا" نحو المدرسة الوحيدة في المدينة، بعد أن تخطت خطوتها. في طريقها، رأت صبيًّا فضوليًا ومغامرًا بابتسامة مرحة، وهو صبيّ فضولي ومغامر. "Hey, Anya"، صاح. "هل يمكنني رؤية حقيبة الظهر الخاصة بك؟"

ترددت أيا للحظة قبل فك ضغط الجنيح والكشف عن محتوياته. اتسعت عيون صامويل من دهشته بينما كان يلقي نظرة على الداخل. وكان هناك بين أقلام رصاص ودفاتر سيف لامع، وكتاب تعاويذ قديمة، وبوصلة صغيرة كانت تتجه دائمًا نحو الشمال، ومفتاح سحري يمكنه فتح أي قفل.

وقد أُعجبا معًا بعجائب حقيبة الظهر، ووعدوا بالحفاظ على أسرارها آمنة. عند اقترابهما من دار المدرسة، لاحظت أنيا مجموعة من الأطفال الأكبر سنًا مجتمعين ووجوههم محفورة في الخوف. فضولها لتتحسّن معها، واقتربت بحذر.

"ما المشكلة؟" طرحت عليها.

قدَّم صبي طويل نحيف إلى الأمام. "هناك وحش في الغابة"، تَعَذَّرَ. "لقد كانت ترويع المدينة وتهاجم الحيوانات وحتى الأشخاص".

غرق قلب أمل. كانت بلدة ويلو كريك صغيرة وهادئة، وفكرت وجود وحش في رعبتها أسفل عمودها الفقري. كانت تعلم أنه ينبغي عليها القيام بشيء ما لحماية عائلتها وأصدقائها.

وبدون تردّد للحظة، فتحت أنيا حقيبة الظهر واسترجع السيف المتلألئ. ولمعانة عينيها، لجأت إلى أقرانها المرعوبين. "لا تقلق"، قالت، صوتها ثابت. "سأعتني بذلك".

مع اقتراب "سامويل" خلفها، تغامر "أنيا" في الأعماق الغامضة للغابة. بدا أنّ الأشجار تهمس بالأسرار أثناء مرورها، واختلطت الشجيرات بالكائنات غير المرئية. وَبَيْنَمَا تَجَاوَزُ الْهَوَاءْ أَكْثَرَ فِي الْغَابَة، بَلَغَ الْهَوَاءْ كَثِيفَة وَالْأَرضَ تَحْتَ أقدامهم ارتجعت.

فجأة، جاءوا إلى جزيرة خالية، وكان هناك أمام عيني الوحش - وحش ضخم ذو أسنان حادة، وعينان حمراء لامعة، ومخالب يمكن أن تسحق البشر بسهولة. زُر المخلوق، مع صوت رعدٍ هزّ الغابة إلى جوهرها.

كان الخوف قد تغلب على آنية، لكنها رفضت السماح له باستهلاكها. سحبت السيف من غمده وشبح نحو الوحش. ولمعان النصل في ضوء الشمس، وعندما ضربت خبأ الوحش، اندلع ضوء ساطع يغلف كل شيء بإشراقه.

عندما تلاشى الضوء، اختفى الوحش وحلت في مكانه كومة من البلورات المحطمة. هزمت أنيا المخلوق بسحر حقيبة ظهرها، مما يثبت أنه حتى أصغر الأشياء يمكن أن تحمل أعظم القوى.

عِنْدَمَا عادَت هي و"صامويل" إلى المدينة، كان يتمّ الترحيب بهما كأبطال. ابتهج سكان ويلو كريك، وتوارثت أسطورة أنيا، الفتاة التي تحمل حقيبة الظهر السحرية، عبر الأجيال. وهكذا، واصلت أنيا مغامراتها مستخدمًا عجائب حقيبة الظهر لجعل العالم مكانًا أفضل، بخطوة سحرية واحدة في كل مرة.

استخدام اللغة الطبيعية

النماذج اللغوية الكبيرة هي أدوات فعّالة لتنفيذ مهام متعددة. سيكون بإمكانك في كثير من الأحيان أن تطلب من Gemini تنفيذ طلبك.

لا تتوفّر وضع JSON في Gemini API، لذا يجب التنبّه إلى بعض النقاط عند إنشاء بنى البيانات على النحو التالي:

يتعذّر في بعض الأحيان إجراء التحليل.
لا يمكن فرض المخطط بصرامة.

يمكنك حل هذه المشكلات في القسم التالي. أولاً، جرِّب طلبًا بسيطًا بلغة طبيعية مع كتابة المخطط كنص. لم يتم تحسين هذا:

model = genai.GenerativeModel(
    model_name='models/gemini-1.5-pro-latest')

response = model.generate_content(
  textwrap.dedent("""\
    Please return JSON describing the the people, places, things and relationships from this story using the following schema:

    {"people": list[PERSON], "places":list[PLACE], "things":list[THING], "relationships": list[RELATIONSHIP]}

    PERSON = {"name": str, "description": str, "start_place_name": str, "end_place_name": str}
    PLACE = {"name": str, "description": str}
    THING = {"name": str, "description": str, "start_place_name": str, "end_place_name": str}
    RELATIONSHIP = {"person_1_name": str, "person_2_name": str, "relationship": str}

    All fields are required.

    Important: Only return a single piece of valid JSON text.

    Here is the story:

    """) + story,
  generation_config={'response_mime_type':'application/json'}
)

response.text

'{"people": [\n    {\n        "name": "Anya",\n        "description": "A young girl who lives in the town of Willow Creek with her parents, Elise and Edward. She possesses a magical backpack that was handed down to her from her grandmother.",\n        "start_place_name": "Willow Creek",\n        "end_place_name": "Willow Creek"\n    },\n    {\n        "name": "Elise",\n        "description": "Anya\'s kind-hearted mother",\n        "start_place_name": "Willow Creek",\n        "end_place_name": "Willow Creek"\n    },\n    {\n        "name": "Edward",\n        "description": "Anya\'s wise-bearded father",\n        "start_place_name": "Willow Creek",\n        "end_place_name": "Willow Creek"\n    },\n    {\n        "name": "Samuel",\n        "description": "Anya\'s best friend, a curious and adventurous boy with a mischievous grin.",\n        "start_place_name": "Willow Creek",\n        "end_place_name": "Willow Creek"\n    },\n    {\n        "name": "Monster",\n        "description": "A massive beast with sharp teeth, glowing red eyes, and claws that could crush a human with ease.",\n        "start_place_name": "Forest",\n        "end_place_name": "Forest"\n    }\n], "places": [\n    {\n        "name": "Willow Creek",\n        "description": "A quaint town nestled amidst rolling hills and whispering willows."\n    },\n    {\n        "name": "Forest",\n        "description": "A shadowy place with rustling undergrowth and whispering trees."\n    },\n    {\n        "name": "Schoolhouse",\n        "description": "The only school in the town of Willow Creek."\n    },\n    {\n        "name": "Anya\'s home",\n        "description": "A modest cottage with a creaky wooden door."\n    }\n], "things": [\n    {\n        "name": "Magic backpack",\n        "description": "A magical backpack that was handed down to Anya from her grandmother. Its soft, emerald-green fabric shimmered with an ethereal glow, and its leather straps held secrets that only Anya knew.",\n        "start_place_name": "Anya\'s home",\n        "end_place_name": "Forest"\n    },\n    {\n        "name": "Shimmering sword",\n        "description": "A sword that shimmered in the sunlight and could strike with blinding light.",\n        "start_place_name": "Magic backpack",\n        "end_place_name": "Forest"\n    },\n    {\n        "name": "Book of ancient spells",\n        "description": "A book that contained ancient spells.",\n        "start_place_name": "Magic backpack",\n        "end_place_name": "Forest"\n    },\n    {\n        "name": "Tiny compass",\n        "description": "A compass that always pointed north.",\n        "start_place_name": "Magic backpack",\n        "end_place_name": "Forest"\n    },\n    {\n        "name": "Magical key",\n        "description": "A key that could open any lock.",\n        "start_place_name": "Magic backpack",\n        "end_place_name": "Forest"\n    },\n    {\n        "name": "Shattered crystals",\n        "description": "The remains of the monster after it was defeated by Anya\'s magic backpack.",\n        "start_place_name": "Forest",\n        "end_place_name": "Forest"\n    }\n], "relationships": [\n    {\n        "person_1_name": "Anya",\n        "person_2_name": "Elise",\n        "relationship": "mother-daughter"\n    },\n    {\n        "person_1_name": "Anya",\n        "person_2_name": "Edward",\n        "relationship": "father-daughter"\n    },\n    {\n        "person_1_name": "Anya",\n        "person_2_name": "Samuel",\n        "relationship": "best friends"\n    }\n]}'

أدى ذلك إلى عرض سلسلة json. حاول تحليله:

import json

print(json.dumps(json.loads(response.text), indent=4))

{
    "people": [
        {
            "name": "Anya",
            "description": "A young girl who lives in the town of Willow Creek with her parents, Elise and Edward. She possesses a magical backpack that was handed down to her from her grandmother.",
            "start_place_name": "Willow Creek",
            "end_place_name": "Willow Creek"
        },
        {
            "name": "Elise",
            "description": "Anya's kind-hearted mother",
            "start_place_name": "Willow Creek",
            "end_place_name": "Willow Creek"
        },
        {
            "name": "Edward",
            "description": "Anya's wise-bearded father",
            "start_place_name": "Willow Creek",
            "end_place_name": "Willow Creek"
        },
        {
            "name": "Samuel",
            "description": "Anya's best friend, a curious and adventurous boy with a mischievous grin.",
            "start_place_name": "Willow Creek",
            "end_place_name": "Willow Creek"
        },
        {
            "name": "Monster",
            "description": "A massive beast with sharp teeth, glowing red eyes, and claws that could crush a human with ease.",
            "start_place_name": "Forest",
            "end_place_name": "Forest"
        }
    ],
    "places": [
        {
            "name": "Willow Creek",
            "description": "A quaint town nestled amidst rolling hills and whispering willows."
        },
        {
            "name": "Forest",
            "description": "A shadowy place with rustling undergrowth and whispering trees."
        },
        {
            "name": "Schoolhouse",
            "description": "The only school in the town of Willow Creek."
        },
        {
            "name": "Anya's home",
            "description": "A modest cottage with a creaky wooden door."
        }
    ],
    "things": [
        {
            "name": "Magic backpack",
            "description": "A magical backpack that was handed down to Anya from her grandmother. Its soft, emerald-green fabric shimmered with an ethereal glow, and its leather straps held secrets that only Anya knew.",
            "start_place_name": "Anya's home",
            "end_place_name": "Forest"
        },
        {
            "name": "Shimmering sword",
            "description": "A sword that shimmered in the sunlight and could strike with blinding light.",
            "start_place_name": "Magic backpack",
            "end_place_name": "Forest"
        },
        {
            "name": "Book of ancient spells",
            "description": "A book that contained ancient spells.",
            "start_place_name": "Magic backpack",
            "end_place_name": "Forest"
        },
        {
            "name": "Tiny compass",
            "description": "A compass that always pointed north.",
            "start_place_name": "Magic backpack",
            "end_place_name": "Forest"
        },
        {
            "name": "Magical key",
            "description": "A key that could open any lock.",
            "start_place_name": "Magic backpack",
            "end_place_name": "Forest"
        },
        {
            "name": "Shattered crystals",
            "description": "The remains of the monster after it was defeated by Anya's magic backpack.",
            "start_place_name": "Forest",
            "end_place_name": "Forest"
        }
    ],
    "relationships": [
        {
            "person_1_name": "Anya",
            "person_2_name": "Elise",
            "relationship": "mother-daughter"
        },
        {
            "person_1_name": "Anya",
            "person_2_name": "Edward",
            "relationship": "father-daughter"
        },
        {
            "person_1_name": "Anya",
            "person_2_name": "Samuel",
            "relationship": "best friends"
        }
    ]
}

هذا الأمر بسيط نسبيًا وقد نجح في كثير من الأحيان، ولكن يمكنك زيادة صرامة هذا الأمر أو صرامته عن طريق تحديد المخطط باستخدام ميزة استدعاء الدوال في واجهة برمجة التطبيقات.

استخدام استدعاء الدوال

إذا لم تكن قد اطّلعت على البرنامج التعليمي أساسيات الاتصال بالدوال بعد، تأكّد من إكماله أولاً.

من خلال استدعاء الدالة وتوضيح معلماتها لواجهة برمجة التطبيقات بصفتك genai.protos.FunctionDeclaration. وفي الحالات الأساسية، يمكن لحزمة SDK إنشاء FunctionDeclaration من الدالة وتعليقاتها التوضيحية. إذًا، ستحتاج إلى تحديدها بشكل صريح في الوقت الحالي.

تعريف المخطط

ابدأ بتعريف person ككائن بحقول السلاسل name وdescription وstart_place_name وend_place_name.

person = genai.protos.Schema(
    type = genai.protos.Type.OBJECT,
    properties = {
        'name':  genai.protos.Schema(type=genai.protos.Type.STRING),
        'description':  genai.protos.Schema(type=genai.protos.Type.STRING),
        'start_place_name': genai.protos.Schema(type=genai.protos.Type.STRING),
        'end_place_name': genai.protos.Schema(type=genai.protos.Type.STRING)
    },
    required=['name', 'description', 'start_place_name', 'end_place_name']
)

بعد ذلك، يمكنك تحديد الأشخاص على أنّهم ARRAY من إجمالي person عنصر:

people = genai.protos.Schema(
    type=genai.protos.Type.ARRAY,
    items=person
)

بعد ذلك، نفِّذ الإجراء نفسه لكل كيان من الكيانات التي تحاول استخراجها:

place = genai.protos.Schema(
    type = genai.protos.Type.OBJECT,
    properties = {
        'name':  genai.protos.Schema(type=genai.protos.Type.STRING),
        'description':  genai.protos.Schema(type=genai.protos.Type.STRING),
    }
)

places = genai.protos.Schema(
    type=genai.protos.Type.ARRAY,
    items=place
)

thing = genai.protos.Schema(
  type = genai.protos.Type.OBJECT,
  properties = {
      'name':  genai.protos.Schema(type=genai.protos.Type.STRING),
      'description':  genai.protos.Schema(type=genai.protos.Type.STRING),
  }
)

things = genai.protos.Schema(
    type=genai.protos.Type.ARRAY,
    items=thing
)

relationship = genai.protos.Schema(
    type = genai.protos.Type.OBJECT,
    properties = {
        'person_1_name':  genai.protos.Schema(type=genai.protos.Type.STRING),
        'person_2_name':  genai.protos.Schema(type=genai.protos.Type.STRING),
        'relationship':  genai.protos.Schema(type=genai.protos.Type.STRING),
    }
)

relationships = genai.protos.Schema(
    type=genai.protos.Type.ARRAY,
    items=relationship
)

عليك الآن إنشاء FunctionDeclaration:

add_to_database = genai.protos.FunctionDeclaration(
    name="add_to_database",
    description=textwrap.dedent("""\
        Adds entities to the database.
        """),
    parameters=genai.protos.Schema(
        type=genai.protos.Type.OBJECT,
        properties = {
            'people': people,
            'places': places,
            'things': things,
            'relationships': relationships
        }
    )
)

استدعاء واجهة برمجة التطبيقات

كما رأيت في أساسيات استدعاء الدوال، يمكنك الآن تمرير FunctionDeclaration هذه إلى الوسيطة tools للدالة الإنشائية genai.GenerativeModel (ستقبل الدالة الإنشائية أيضًا تمثيل JSON مكافئ لبيان الدالة):

model = genai.GenerativeModel(
    model_name='models/gemini-1.5-pro-latest',
    tools = [add_to_database])

في كل مرة يتم فيها استدعاء واجهة برمجة التطبيقات، سترسل حزمة SDK الأدوات مع طلبك، ويجب أن يستدعي النموذج هذه الوظيفة التي حددتها:

result = model.generate_content(f"""
Please add the people, places, things, and relationships from this story to the database:

{story}
""",
# Force a function call
tool_config={'function_calling_config':'ANY'})

الآن لا يوجد نص لتحليله. والنتيجة هي بنية بيانات.

'text' in result.candidates[0].content.parts[0]

False

'function_call' in result.candidates[0].content.parts[0]

True

fc = result.candidates[0].content.parts[0].function_call
print(type(fc))

<class 'google.ai.generativelanguage_v1beta.types.content.FunctionCall'>

تعتمد الفئة genai.protos.FunctionCall على الموارد الاحتياطية لبروتوكول Google، تحويله إلى كائن متوافق مع JSON مألوف أكثر:

print(json.dumps(type(fc).to_dict(fc), indent=4))

{
    "name": "add_to_database",
    "args": {
        "things": [
            {
                "name": "Magical Backpack",
                "description": "Anya's prized possession, the Magical Backpack, is no ordinary satchel. Its soft, emerald-green fabric shimmers with an ethereal glow, and its leather straps have secrets that only Anya knows. Within its capacious interior lay an enchanted world, filled with wonders that would ignite her imagination and change her life forever."
            },
            {
                "name": "Shimmering Sword",
                "description": "Among the wonders in Anya's Magical Backpack, lies a shimmering sword. With a determined gleam in her eye, she retrieved the shimmering sword and charged towards the monster."
            },
            {
                "description": "Residing within the Magical Backpack, the Book of Ancient Spells holds secrets untold.",
                "name": "Book of Ancient Spells"
            },
            {
                "description": "Tucked away in the Magical Backpack is a tiny compass that always points north.",
                "name": "Tiny Compass that Always Points North"
            },
            {
                "description": "Hidden within the Magical Backpack is a magical key that can open any lock.",
                "name": "Magical Key that Can Open Any Lock"
            }
        ],
        "relationships": [
            {
                "relationship": "Mother-Daughter",
                "person_1_name": "Anya",
                "person_2_name": "Elise"
            },
            {
                "person_2_name": "Edward",
                "relationship": "Father-Daughter",
                "person_1_name": "Anya"
            },
            {
                "person_2_name": "Samuel",
                "person_1_name": "Anya",
                "relationship": "Best Friends"
            }
        ],
        "people": [
            {
                "name": "Anya",
                "description": "Anya, the main character of the story, is a young girl with a magical backpack.",
                "start_place_name": "Willow Creek",
                "end_place_name": "Unknown"
            },
            {
                "name": "Elise",
                "description": "Anya's mother, Elise is a kind-hearted woman.",
                "end_place_name": "Unknown",
                "start_place_name": "Willow Creek"
            },
            {
                "start_place_name": "Willow Creek",
                "end_place_name": "Unknown",
                "name": "Edward",
                "description": "Anya's father, Edward is a wise-bearded man."
            },
            {
                "end_place_name": "Unknown",
                "start_place_name": "Willow Creek",
                "description": "Anya's best friend, Samuel is a curious and adventurous boy with a mischievous grin.",
                "name": "Samuel"
            }
        ],
        "places": [
            {
                "description": "The quaint town of Willow Creek is nestled amidst rolling hills and whispering willows.",
                "name": "Willow Creek"
            },
            {
                "description": "The town's only schoolhouse.",
                "name": "Schoolhouse"
            },
            {
                "description": "A shadowy place filled with secrets and dangers, the Forest is home to a terrifying monster.",
                "name": "Forest"
            }
        ]
    }
}

الخاتمة

على الرغم من أنّ واجهة برمجة التطبيقات يمكنها معالجة مشاكل استخراج البيانات المنظَّمة باستخدام إدخال نص خالص وإخراج نصي، من المرجّح أن يكون استخدام استدعاء الدوال أكثر موثوقية لأنّه يتيح لك تحديد مخطط متشدد، كما يلغي خطوة التحليل التي يُحتمل أن تكون عرضة للخطأ.