<!-- Canonical URL: https://ask.atlascloud.ai/nl/migrate-together-ai-batch-job-without-losing-request-ids -->

# Hoe migreer je een Together AI-batchtaak zonder aanvraag-ID's te verliezen?

> Laat elke custom_id van de applicatie ongewijzigd en bewaar bestands-, batch- en antwoord-ID's van beide providers afzonderlijk. Valideer de volledige set voor verzending, koppel uitvoer en fouten op ID en registreer pogingen zonder de bedrijfssleutel te wijzigen.

Behandel elke bron-`custom_id` als onveranderlijke applicatiedata. Kopieer deze ongewijzigd naar de doelaanvraag, sla batch- en antwoord-ID's van het doel apart op en koppel resultaten op `custom_id`, niet op bestandsvolgorde.

Het onderscheid tussen een ID van de applicatie en ID's van providers is essentieel. Behoud de eerste en map de overige.

## Inventariseer alle ID's

Together-batchinvoer gebruikt JSONL. Elke regel bevat een unieke `custom_id` en aanvraagbody. Batch, invoerbestand, uitvoerbestand en antwoord kunnen verschillende ID's hebben.

| Identificator | Eigenaar | Migratieregel |
|---|---|---|
| `custom_id` | Applicatie | Exact behouden |
| Bron-batch-ID | Together | Als bronmetadata opslaan |
| Doel-batch-ID | Doelprovider | Apart opslaan |
| Invoer- en uitvoerbestand-ID | Elke provider | Niet als bedrijfssleutel gebruiken |
| Antwoord-ID | Model-API | Voor support en facturering bewaren |

Vervang `custom_id` niet door regelnummers, tenzij dit al een duurzame sleutel is. De volgorde kan veranderen en fouten kunnen in een apart bestand staan.

## Maak een migratielogboek

Maak vóór verzending één record per logische aanvraag:

```json
{
  "custom_id": "invoice-2026-00421",
  "source_batch_id": "batch_source",
  "target_batch_id": null,
  "payload_sha256": "...",
  "state": "prepared"
}
```

Zorg dat `custom_id` uniek is en voeg een hash van de genormaliseerde body toe. Zo detecteer je wijzigingen zonder gevoelige inhoud dubbel op te slaan.

## Converteer de envelop, niet de identiteit

Batchenveloppen verschillen. Together plaatst `custom_id` naast `body`; een andere OpenAI-compatibele API kan ook `method` en `url` vereisen.

```json
{"custom_id":"invoice-2026-00421","method":"POST","url":"/v1/chat/completions","body":{"model":"target-model","messages":[{"role":"user","content":"Classify this record"}]}}
```

Wijzig endpoint, model en niet-ondersteunde parameters in een converter. Behandel `custom_id` als ondoorzichtige tekenreeks en kort, vertaal of regenereer deze niet.

## Valideer vóór verzending

Controleer het gegenereerde JSONL:

* elke regel is zelfstandig parseerbaar;
* elke `custom_id` bestaat en is uniek;
* de ID-set komt overeen met het bronmanifest;
* elke body voldoet aan het schema van het doel.

Noteer de hash en het regelaantal van het eindbestand. Upload precies dat artefact en koppel de teruggegeven ID's aan het logboek.

## Koppel uitvoer en fouten samen

Download na voltooiing uitvoer en fouten. Indexeer elke regel op `custom_id` en vergelijk hun combinatie met de verzonden set.

Classificeer elk ID als geslaagd, mislukt, ontbrekend of dubbel. Een voltooide batch is niet automatisch gereconcilieerd. Elk ID moet exact één eindstatus hebben.

## Probeer opnieuw zonder identiteit te wijzigen

Maak een nieuwe batch met alleen mislukte of ontbrekende aanvragen. Behoud dezelfde `custom_id` en verhoog `attempt` in het logboek.

Als hergebruik niet mag, bewaar dan het origineel in een applicatieveld en maak een omkeerbare transportkoppeling.

## Schakel veilig over

Begin met een kleine representatieve batch. Vergelijk succes, latency, tokens, output, fouten en kosten. Houd bron- en doelresultaten parallel totdat reconciliatie deterministisch is.

Automatiseer drie assertions: geen onbekende ID's, geen dubbele eindresultaten en geen ontbrekende ID's.

## Samenvatting

Behoud de applicatie-`custom_id`, converteer alleen de providerenvelop en houd een koppelingslogboek bij. Reconcilieer output en fouten op ID, registreer pogingen en schakel pas over wanneer elke aanvraag een eindresultaat heeft.

## FAQ

### Welke ID moet stabiel blijven bij een Together-batchmigratie?

Behoud de custom_id die je applicatie heeft toegewezen. Batch-, bestands- en antwoord-ID's van providers zijn afzonderlijke metadata en niet de bedrijfssleutel.

### Kan ik batchresultaten op regelnummer koppelen?

Nee. De uitvoervolgorde kan verschillen en fouten kunnen in een ander bestand staan. Koppel de combinatie van uitvoer en fouten via custom_id.

### Wat hoort in het migratielogboek?

Bewaar custom_id, de hash van de genormaliseerde payload, bron- en doel-ID's voor batch en bestand, pogingnummer, tijdstippen en één eindstatus per aanvraag.

### Heeft een nieuwe poging een nieuwe custom_id nodig?

Meestal niet. Behoud de bedrijfs-ID en verhoog attempt. Als de transport-ID uniek moet zijn, bewaar dan een omkeerbare koppeling naar de originele custom_id.

### Hoe vind ik verloren aanvragen?

Vergelijk de verzonden ID-set met de combinatie van geslaagde en fout-ID's. Markeer ontbrekende, onbekende en dubbele ID's vóór afronding.

### Kan ik een Together-invoerbestand ongewijzigd hergebruiken?

Alleen als het doel dezelfde envelop, endpoint, model-ID en parameters accepteert. Meestal is een converter nodig die custom_id behoudt.
