> ## 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. Create managed config jobs with POST /v1/training/jobs using base_model. For custom training loops, 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.

# Azure-Blob-Daten mit einem Coding-Agent verbinden

> Lassen Sie Cursor, Claude Code oder Codex einen Azure-Blob-Container mit schreibgeschütztem Zugriff an ein Fastino-Projekt anbinden.

Sie müssen keine API-Anfragen von Hand erstellen. Der Agent ermittelt die
Azure-Ressourcendaten, erstellt den Projekt-Connector, begleitet die
Microsoft-Zustimmung, vergibt Leserechte auf den Container, testet die Verbindung
und startet einen unveränderlichen Snapshot.

## Benötigte Angaben

* Die URL des Azure-Blob-Containers, optional mit Blob-Präfix.
* Name oder ID des Fastino-Projekts.
* Verwendungszweck: `training` oder `evaluation`.

Tenant, Abonnement, Ressourcengruppe, Speicherkonto und Container ermittelt der
Agent über Ihre authentifizierte Azure-CLI-Sitzung. Er prüft diese Werte anhand
der Azure-Metadaten des Speicherkontos, nicht anhand Ihres aktiven
CLI-Abonnements. Kann er sie nicht prüfen, hält er an und nennt die fehlenden
Angaben, statt zu raten.

## Voraussetzungen

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

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

Melden Sie sich im Verzeichnis und Abonnement des Speicherkontos an:

```bash theme={null}
az login
az account show
```

Ihre Azure-Identität muss Rollen am Container zuweisen dürfen, etwa als
**Owner** oder **User Access Administrator**.

> [!NOTE]
>
> Azure-Abonnementrollen und Microsoft-Entra-Verzeichnisrollen sind getrennt. Ein
> Owner kann Blob-RBAC vergeben, aber nicht zwingend eine neue Unternehmensanwendung
> genehmigen.

## Auftrag an den Agenten

```text theme={null}
Verbinde https://customerdata.blob.core.windows.net/training/incoming/
mit meinem Fastino-Projekt "support-classifier" als Trainingsdaten.

Verwende meine aktuelle Azure-CLI-Sitzung. Vergib ausschließlich Storage Blob
Data Reader auf diesem Container, teste und synchronisiere den Connector, warte
auf den Abschluss und melde die erzeugten Datasets. Starte kein Training.
```

## Synchronisierungsergebnisse

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

* Besteht eine Datei die Validierung nicht, schlägt die Synchronisierung fehl und
  veröffentlicht kein Dataset. 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 Datasets sind nutzbar, einige Dateien fehlen) oder
  `transient` (nichts Neues veröffentlicht) markiert und listet
  `retryable_files`. Lassen Sie den Agenten erneut synchronisieren, ohne erneut
  zu testen oder das Präfix zu ändern.
* Wenn Sie ein Fine-Tuning über Fastino MCP delegieren, ist eine
  Synchronisierung optional. Nach der Freigabe des Plans kann der
  Fine-Tuning-Agent die Rohdateien im verbundenen Container prüfen und
  vorverarbeiten.

## Zustimmung und Sicherheit

Beim ersten Container in einem Azure-Tenant muss eine Person aus diesem Tenant
`setup.consent_url` im Browser öffnen, um die Fastino-Unternehmensanwendung
anzulegen. Der Agent kann nicht stellvertretend zustimmen. Ist die Anwendung
bereits vorhanden, ist keine erneute Zustimmung nötig. Ein Benutzer darf nur
zustimmen, wenn die Tenant-Richtlinie die Zustimmung zu dieser Anwendung
erlaubt. Manche Tenants beschränken externe Anwendungen ohne verifizierten
Herausgeber. Wird die Benutzerzustimmung blockiert, geben Sie
`setup.admin_consent_url` an einen Entra **Cloud Application Administrator**
oder **Global Administrator** weiter. Die Owner-Rolle des Abonnements ersetzt
diese Verzeichnisberechtigung nicht.

Die Zustimmung gewährt noch keinen Blob-Zugriff. Nach dem Connector-Test weist
ein Owner oder User Access Administrator dem gewählten Container **Storage Blob
Data Reader** zu. Jeder weitere Container benötigt eine eigene Rollenzuweisung,
aber keine erneute Zustimmung. Kunden müssen Fastinos App-Registrierung nie
selbst ändern.

Fastino akzeptiert keine Kontoschlüssel, SAS-Token, Client-Geheimnisse oder
Kundenzertifikate. Zur Laufzeit nutzt Fastino die eigene zertifikatsbasierte
Identität und **Storage Blob Data Reader**, begrenzt auf den gewählten Container.

## Fehlerbehebung

| Status oder Microsoft-Fehler | Bedeutung | Maßnahme |
| - | - | - |
| `consent_missing` | Die Fastino-Unternehmensanwendung fehlt im Tenant | Zustimmungs-URL öffnen; Administrator nur verwenden, wenn die Richtlinie es verlangt |
| `AADSTS1003031` | Fastinos Entra-App-Registrierung ist fehlerhaft; der Fehler kann bei der Zustimmung oder als `provider_error_code` mit `consent_missing` auftreten | Fastino-Support kontaktieren; weder die App-Registrierung des eigenen Tenants noch Blob-RBAC als Behelf ändern |
| `role_missing` | Zustimmung vorhanden, Blob-RBAC fehlt | Zurückgegebenen Rollenbefehl ausführen und erneut testen |
| `container_missing` | Speicherkoordinaten stimmen nicht | Ressource anhand der Container-URL neu ermitteln lassen |
| `unavailable` | Azure oder Fastino konnte den Test nicht abschließen | Test wiederholen; bei anhaltendem Fehler den Fastino-Support kontaktieren |

Die RBAC-Übernahme kann mehrere Minuten dauern. Lassen Sie den Agenten erneut
testen, bevor Sie einen weiteren Connector erstellen.


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