참고소스 수정본

참고/instructor-main/docs/examples/examples.md

@@ -0,0 +1,72 @@
+---
+title: Few-Shot Learning with Examples - Pydantic Models
+description: Enhance Pydantic models with practical examples for few-shot learning. Improve LLM understanding with example-driven JSON schemas.
+---
+
+# How should I include examples?
+
+To enhance the clarity and usability of your model and prompt, incorporating examples directly into the JSON schema extra of your Pydantic model is highly recommended. This approach not only streamlines the integration of practical examples but also ensures that they are easily accessible and understandable within the context of your model's schema.
+
+```python
+import instructor
+from typing import Iterable
+from pydantic import BaseModel, ConfigDict
+
+client = instructor.from_provider("openai/gpt-5-nano")
+
+
+class SyntheticQA(BaseModel):
+    question: str
+    answer: str
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            "examples": [
+                {"question": "What is the capital of France?", "answer": "Paris"},
+                {
+                    "question": "What is the largest planet in our solar system?",
+                    "answer": "Jupiter",
+                },
+                {
+                    "question": "Who wrote 'To Kill a Mockingbird'?",
+                    "answer": "Harper Lee",
+                },
+                {
+                    "question": "What element does 'O' represent on the periodic table?",
+                    "answer": "Oxygen",
+                },
+            ]
+        }
+    )
+
+
+def get_synthetic_data() -> Iterable[SyntheticQA]:
+    return client.create(
+        model="gpt-4o-mini",
+        messages=[
+            {"role": "system", "content": "Generate synthetic examples"},
+            {
+                "role": "user",
+                "content": "Generate the exact examples you see in the examples of this prompt. ",
+            },
+        ],
+        response_model=Iterable[SyntheticQA],
+    )  # type: ignore
+
+
+if __name__ == "__main__":
+    for example in get_synthetic_data():
+        print(example)
+        #> question='What is the capital of France?' answer='Paris'
+        #> question='What is the largest planet in our solar system?' answer='Jupiter'
+        #> question="Who wrote 'To Kill a Mockingbird'?" answer='Harper Lee'
+        """
+        question="What element does 'O' represent on the periodic table?" answer='Oxygen'
+        """
+        """
+        question="What element does 'O' represent on the periodic table?" answer='Oxygen'
+        """
+        """
+        question="What element does 'O' represent on the periodic table?" answer='Oxygen'
+        """
+```