> ## 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.

# Connecter des données Azure Blob avec un agent

> Demandez à Cursor, Claude Code ou Codex de connecter un conteneur Azure Blob à un projet Fastino avec un accès en lecture seule.

Vous n'avez pas à construire les requêtes API manuellement. L'agent découvre les
coordonnées Azure, crée le connecteur du projet, guide le consentement Microsoft,
accorde un accès en lecture au conteneur, teste la connexion et lance un snapshot
immuable.

## Informations à fournir

* L'URL du conteneur Azure Blob, avec un préfixe facultatif.
* Le nom ou l'ID du projet Fastino.
* L'usage des données : `training` ou `evaluation`.

L'agent déduit le tenant, l'abonnement, le groupe de ressources, le compte de
stockage et le conteneur depuis votre session Azure CLI authentifiée. Il vérifie
ces valeurs à partir des métadonnées Azure du compte de stockage, et non de votre
abonnement CLI actif. S'il ne peut pas les vérifier, il s'arrête et vous indique
ce qui manque au lieu de deviner.

## Avant de commencer

Connectez l'agent au endpoint MCP de votre équipe :

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

Connectez-vous au répertoire et à l'abonnement propriétaires du stockage :

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

Votre identité doit pouvoir attribuer des rôles sur le conteneur, par exemple
avec **Owner** ou **User Access Administrator**.

> [!NOTE]
>
> Les rôles d'abonnement Azure et les rôles de répertoire Microsoft Entra sont
> distincts. Un Owner peut attribuer le RBAC sans forcément pouvoir approuver une
> nouvelle application d'entreprise.

## Demander à l'agent

```text theme={null}
Connecte https://customerdata.blob.core.windows.net/training/incoming/
à mon projet Fastino "support-classifier" comme données d'entraînement.

Utilise ma session Azure CLI actuelle. Accorde uniquement Storage Blob Data
Reader sur ce conteneur, teste le connecteur, synchronise-le, attends la fin et
indique les datasets créés. Ne lance pas d'entraînement.
```

## Résultats de la synchronisation

La synchronisation convertit et valide les fichiers du préfixe sélectionné avant
de publier des datasets. Une synchronisation réussie liste ses datasets dans le
rapport.

* Si un fichier échoue à la validation, la synchronisation échoue et ne publie
  aucun dataset. Le rapport liste les fichiers à examiner. L'agent vous transmet
  ces échecs et vous demande votre accord avant d'exclure des fichiers ou de
  modifier le préfixe.
* Si la conversion de documents atteint une limite de débit, le rapport est marqué
  `partial` (les datasets listés sont utilisables, certains fichiers manquent) ou
  `transient` (rien de nouveau n'a été publié) et liste `retryable_files`.
  Demandez à l'agent de relancer la synchronisation sans retester ni modifier le
  préfixe.
* La synchronisation est facultative si vous déléguez un fine-tuning via Fastino
  MCP. Une fois le plan approuvé, l'agent de fine-tuning peut inspecter et
  prétraiter les fichiers bruts du conteneur connecté.

## Consentement et sécurité

Pour le premier conteneur d'un tenant Azure, une personne de ce tenant doit
ouvrir `setup.consent_url` dans un navigateur pour créer l'application
d'entreprise Fastino. L'agent ne peut pas approuver ce consentement à votre
place. Si l'application existe déjà, aucun nouveau consentement n'est requis.
Un utilisateur peut approuver uniquement si la politique du tenant l'autorise
pour cette application. Certains tenants limitent le consentement aux
applications externes sans éditeur vérifié. Sinon, transmettez
`setup.admin_consent_url` à un **Cloud Application Administrator** ou
**Global Administrator** Entra. Le rôle Owner de l'abonnement ne remplace pas
cette autorisation de répertoire.

Le consentement ne donne pas accès aux blobs. Après le test du connecteur,
un Owner ou User Access Administrator attribue **Storage Blob Data Reader**
sur le conteneur choisi. Chaque autre conteneur exige sa propre attribution
de rôle, mais pas un nouveau consentement. Le client n'a jamais à modifier
l'enregistrement de l'application Fastino.

Fastino n'accepte ni clé de compte, ni jeton SAS, ni secret client, ni certificat
client. À l'exécution, Fastino utilise sa propre identité par certificat et le
rôle **Storage Blob Data Reader**, limité au conteneur sélectionné.

## Dépannage

| Statut ou erreur Microsoft | Signification | Action |
| - | - | - |
| `consent_missing` | L'application d'entreprise Fastino n'existe pas dans le tenant | Ouvrez l'URL de consentement ; utilisez un administrateur uniquement si la politique l'exige |
| `AADSTS1003031` | L'application Entra Fastino est mal configurée ; l'erreur peut apparaître lors du consentement ou comme `provider_error_code` avec `consent_missing` | Contactez le support Fastino ; ne modifiez pas l'application de votre tenant ni le RBAC Blob |
| `role_missing` | Le consentement existe, mais le RBAC manque | Exécutez la commande de rôle renvoyée, puis retestez |
| `container_missing` | Les coordonnées de stockage ne correspondent pas | Demandez à l'agent de redécouvrir la ressource depuis l'URL |
| `unavailable` | Azure ou Fastino n'a pas pu terminer le test | Relancez le test ; contactez le support Fastino si l'échec persiste |

La propagation du RBAC peut prendre plusieurs minutes. Réessayez avant de créer
un autre connecteur.


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