Add optional PDF and image attachments to extract.ai

.gitignore

@@ -61,6 +61,8 @@ coverage.xml
 *.py,cover
 .hypothesis/
 .pytest_cache/
+.pytest-*/
+.test-recipe-ai-attachments/
 .test-local/
 
 # Translations

docs/extract_ai_user_guide.md

@@ -4,6 +4,12 @@ Use `extract.ai` when each input row should produce one or more consistently
 named attributes. You can define the attributes in an Excel saved model or
 directly in a recipe. Both routes compile to the same output contract.
 
+For original PDFs and images, use explicit
+[`attachments`](extract_ai_configuration.md#pdf-and-image-attachments) with a
+vision-capable Responses model. Text containing a file path alone does not send
+the file. The configuration guide includes Python/YAML examples, per-record
+association, limits, and usage-accounting guidance for longer visual requests.
+
 ## Start with the output
 
 Define the result you want before writing general instructions or examples.

pytest-local.ini

@@ -1,11 +1,14 @@
 [pytest]
 testpaths =
     tests/test_ai_cache.py
+    tests/test_ai_attachments.py
     tests/test_ai_definition.py
     tests/test_container_smoke.py
     tests/test_data.py
     tests/test_dataframe.py
     tests/test_openai_extract_ai.py
+    tests/test_openai_attempt_diagnostics.py
+    tests/test_recipe_ai_attachments.py
     tests/recipes
     tests/connectors/test_access.py
     tests/connectors/test_concurrent.py