> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fastino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use https://docs.fastino.ai/llms.txt to discover and navigate pages. Use https://docs.fastino.ai/llms-full.txt when you need the complete documentation corpus. Use https://docs.fastino.ai/openapi.json as the source of truth for customer-facing routes. For GLiDE decision inference, call POST https://api.fastino.ai/v1/systemone with model fastino/GLiDE. Start managed training (config job) with POST /v1/training/jobs using base_model. For interactive training, native JSON clients use the public operations under /v1/training/jobs and /v1/training/usage. Existing Tinker clients use tinker==0.32.0 with TINKER_BASE_URL=https://api.fastino.ai/v1/training/compat/tinker and TINKER_CREDENTIAL_CMD. Compatibility child routes are private and absent from OpenAPI. Auto Train is private access and has no public route; direct interested users to sales@fastino.ai. Do not infer undocumented routes. Read API keys from FASTINO_API_KEY and never embed credentials in code, logs, or reports.

# Amazon-S3-Daten mit einem Coding-Agent verbinden

> Lassen Sie Cursor, Claude Code oder Codex einen Amazon-S3-Bucket mit schreibgeschütztem Zugriff an ein Fastino-Projekt anbinden.

Statt API-Anfragen und IAM-Richtlinien von Hand zusammenzustellen, kann ein
Coding-Agent den Projekt-Connector anlegen, in Ihrem AWS-Konto eine
schreibgeschützte IAM-Rolle erstellen, die Fastino übernehmen darf, die
Verbindung testen und einen unveränderlichen Datensatz-Snapshot starten. Sie
behalten die Kontrolle über Ihren Bucket. Fastino importiert ausgewählte Daten in
Ihr Fastino-Projekt, ohne Ihre AWS-Zugriffsschlüssel zu erhalten.

## Was Sie angeben

* Den Bucket-Namen und optional ein Schlüsselpräfix, zum Beispiel `incoming/`.
* Den Namen oder die ID des Fastino-Projekts.
* Den Verwendungszweck der Daten: `training` oder `evaluation`.

Region und Konto des Buckets liest der Agent aus Ihrer angemeldeten AWS-CLI-Sitzung.
Er benennt die IAM-Rolle, die er erstellt; Connector- und Datensatznamen können
vom Bucket-Namen abgeleitet werden.

## Bevor Sie beginnen

Verbinden Sie Ihren Coding-Agent mit dem Fastino-MCP-Endpunkt Ihres Teams:

```text theme={null}
https://api.fastino.ai/v1/teams/YOUR_TEAM_ID/mcp
```

Prüfen Sie anschließend, dass die AWS CLI beim Konto angemeldet ist, dem der Bucket gehört:

```bash theme={null}
aws sts get-caller-identity
```

Ihre AWS-Identität muss in diesem Konto IAM-Rollen erstellen und Inline-Richtlinien
anhängen dürfen, etwa mit `iam:CreateRole`, `iam:UpdateAssumeRolePolicy` und
`iam:PutRolePolicy`.

> [!NOTE]
>
> Erstellen Sie die Rolle in dem Konto, dem der Bucket gehört. Eine Bucket-Richtlinie
> oder Service Control Policy, die die Rolle ablehnt, blockiert Fastino auch dann,
> wenn die eigenen Richtlinien der Rolle das Lesen erlauben.

## Den Agent beauftragen

```text theme={null}
Verbinde den S3-Bucket customer-data mit dem Präfix training/incoming/ als
Trainingsdaten mit meinem Fastino-Projekt "support-classifier".

Nutze meine aktuelle AWS-CLI-Sitzung. Erstelle eine eigene IAM-Rolle, die nur
dieses Präfix lesen darf, teste den Connector, synchronisiere ihn, warte auf den
Abschluss der Synchronisierung und nenne die erzeugten Datensätze. Starte kein
Training.
```

## Was der Agent tut

Die Connector-Antwort enthält `s3_setup`: `external_id` (ein Wert nur für diesen
Connector, den die Vertrauensrichtlinie der Rolle verlangt; er ist nicht geheim),
`broker_role_arn` (die Fastino-Rolle, die Ihre Rolle übernehmen darf), die beiden
IAM-Richtliniendokumente `trust_policy` und `read_policy` sowie `setup_commands`
(AWS-CLI-Befehle, die die Rolle erstellen oder reparieren). Die Rolle muss beim
Anlegen des Connectors noch nicht existieren. Der Agent führt `setup_commands` mit
Ihren AWS-Zugangsdaten aus, testet den reinen Lesezugriff auf die Liste und startet
die Synchronisierung.

## Synchronisierungsergebnisse

Eine Synchronisierung konvertiert und validiert die Dateien unter dem gewählten
Präfix, bevor sie Datensätze veröffentlicht. Eine erfolgreiche Synchronisierung
listet ihre Datensätze im Bericht auf.

* Schlägt die Validierung einer Datei fehl, schlägt die Synchronisierung fehl und
  veröffentlicht keinen Datensatz. Der Bericht nennt die zu prüfenden Dateien. Der
  Agent gibt diese Fehler weiter und fragt nach, bevor er Dateien ausschließt oder
  das Präfix ändert.
* Erreicht die Dokumentkonvertierung ein Ratenlimit, wird der Bericht als `partial`
  (die aufgeführten Datensätze sind nutzbar, einige Dateien fehlen) oder `transient`
  (nichts Neues veröffentlicht) markiert und nennt `retryable_files`. Bitten Sie den
  Agent, erneut zu synchronisieren, ohne neu zu testen oder das Präfix zu ändern.
* Wenn Sie ein Fine-Tuning über Fastino MCP delegieren, ist eine Synchronisierung
  optional. Nach Ihrer Freigabe des Plans kann der Fine-Tune-Agent die Rohdateien
  im verbundenen Bucket prüfen und vorverarbeiten.

## Sicherheitsmodell

Fastino liest Ihren Bucket, indem es die von Ihnen erstellte Rolle übernimmt. Deren
Vertrauensrichtlinie nennt genau eine Fastino-Rolle und verlangt die externe ID
dieses Connectors, sodass weder andere AWS-Prinzipale noch andere Fastino-Kunden
sie nutzen können. Die Leserichtlinie erlaubt `s3:ListBucket` auf dem gewählten
Präfix und `s3:GetObject` auf den Schlüsseln darunter, aber keinen Schreib-,
Lösch- oder Konfigurationszugriff. Fastinos Sitzungen auf Ihrer Rolle sind temporär
und dauern höchstens eine Stunde. Zugriffsschlüssel, geheime Schlüssel und
Sitzungstoken werden nicht akzeptiert.

Ändern Sie Präfix oder Rolle des Connectors, kehrt er bis zum nächsten Test zu
`pending` zurück. Führen Sie nach einer Präfixänderung die neuen
`s3_setup.setup_commands` erneut aus, damit die Leserichtlinie der Rolle passt.
Das Löschen eines Connectors beendet künftige Synchronisierungen, löscht aber keine
bereits veröffentlichten Datensätze. Um den Speicherzugriff zu entziehen, entfernen
Sie die Leseberechtigungen der Rolle und widerrufen ihre [aktiven Sitzungen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_revoke-sessions.html).
IAM-Änderungen können Zeit zur Verteilung benötigen.

## Den Connector mit Ihrem Team teilen

Ein Connector gehört zu genau einem Fastino-Projekt, und ein Projekt ist nur für
seine Ersteller sichtbar, solange seine Sichtbarkeit nicht `team` ist. Legen Sie
das Projekt als Teamprojekt an, etwa indem Sie Ihren Agent bitten, es mit
Team-Sichtbarkeit zu erstellen. Dann sehen Teammitglieder mit den erforderlichen
Teamberechtigungen den Connector,
können ihn synchronisieren und mit seinen Datensätzen feinabstimmen.

Teammitglieder brauchen dafür keinen AWS-Zugriff: Fastino liest den Bucket
über die von Ihnen erstellte IAM-Rolle, nicht über das Konto des Teammitglieds. Nur wer den Connector
einrichtet, braucht AWS-Berechtigungen. Lassen Sie Teammitglieder keinen
zweiten Connector zu demselben Bucket in ihrem eigenen Projekt anlegen; das wiederholt
die Einrichtung und erfordert eigenen AWS-Zugriff.

## Fehlerbehebung

| Status | Bedeutung | Maßnahme |
| - | - | - |
| `trust_missing` | Fastino konnte die Rolle nicht übernehmen: Sie existiert nicht, oder ihre Vertrauensrichtlinie nennt nicht `s3_setup.broker_role_arn` mit `s3_setup.external_id` | `s3_setup.setup_commands` im Konto des Buckets ausführen, dann erneut testen |
| `access_denied` | Die Rolle wurde übernommen, kann das Präfix aber nicht auflisten | `s3_setup.read_policy` an die Rolle anhängen. Nutzt der Bucket SSE-KMS, zusätzlich `kms:Decrypt` auf seinem Schlüssel erlauben. Dann erneut testen |
| `bucket_missing` | Der Bucket existiert nicht oder liegt in einer anderen Region | Bucket-Namen und Region prüfen, dann den Connector aktualisieren |
| `unavailable` | AWS oder Fastino konnte den Test nicht abschließen | Test wiederholen; bei anhaltenden Fehlern den Fastino-Support kontaktieren |

Hat AWS einen Fehlercode geliefert, enthält das Testergebnis ihn in
`provider_error_code`. IAM-Änderungen wirken meist innerhalb von Sekunden, können
aber länger dauern. Der Agent sollte den Test wiederholen, bevor er einen weiteren
Connector anlegt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.