llama-stack-mirror/docs/source/providers
Matthew Farrellee 68877f331e feat: Add optional idempotency support to batches API
Implements optional idempotency for batch creation using `idem_tok` parameter:

* **Core idempotency**: Same token + parameters returns existing batch
* **Conflict detection**: Same token + different parameters raises HTTP 409 ConflictError
* **Metadata order independence**: Different key ordering doesn't affect idempotency

**API changes:**
- Add optional `idem_tok` parameter to `create_batch()` method
- Enhanced API documentation with idempotency extensions

**Implementation:**
- Reference provider supports idempotent batch creation
- ConflictError for proper HTTP 409 status code mapping
- Comprehensive parameter validation

**Testing:**
- Unit tests: focused tests covering core scenarios with parametrized conflict detection
- Integration tests: tests validating real OpenAI client behavior

This enables client-side retry safety and prevents duplicate batch creation
when using the same idempotency token, following REST API
2025-08-08 08:08:08 -04:00
..
agents feat: add batches API with OpenAI compatibility (with inference replay) (#3162) 2025-08-15 15:34:15 -07:00
batches feat: Add optional idempotency support to batches API 2025-08-08 08:08:08 -04:00
datasetio chore(misc): make tests and starter faster (#3042) 2025-08-05 14:55:05 -07:00
eval feat: add batches API with OpenAI compatibility (with inference replay) (#3162) 2025-08-15 15:34:15 -07:00
external chore: bump min python version in docs and tests (#3103) 2025-08-12 08:52:57 -07:00
files chore(misc): make tests and starter faster (#3042) 2025-08-05 14:55:05 -07:00
inference feat: add batches API with OpenAI compatibility (with inference replay) (#3162) 2025-08-15 15:34:15 -07:00
post_training chore(misc): make tests and starter faster (#3042) 2025-08-05 14:55:05 -07:00
safety chore(misc): make tests and starter faster (#3042) 2025-08-05 14:55:05 -07:00
scoring chore(misc): make tests and starter faster (#3042) 2025-08-05 14:55:05 -07:00
telemetry chore(misc): make tests and starter faster (#3042) 2025-08-05 14:55:05 -07:00
tool_runtime chore(misc): make tests and starter faster (#3042) 2025-08-05 14:55:05 -07:00
vector_io docs: Update blocks formatting in docs/source files (#3120) 2025-08-13 08:06:31 -07:00
index.md docs: Reformat external provider documentation (#2982) 2025-07-31 09:21:13 -07:00
openai.md docs: Reorganize documentation on the webpage (#2651) 2025-07-15 14:19:35 -07:00