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

# Conecta datos de Azure Blob con un agente

> Pide a Cursor, Claude Code o Codex que conecte un contenedor de Azure Blob a un proyecto de Fastino con acceso de solo lectura.

No necesitas construir solicitudes API a mano. El agente descubre las coordenadas
de Azure, crea el conector del proyecto, guía el consentimiento de Microsoft,
concede acceso de lectura al contenedor, prueba la conexión e inicia una
instantánea inmutable.

## Lo que debes proporcionar

* La URL del contenedor de Azure Blob, con un prefijo opcional.
* El nombre o ID del proyecto de Fastino.
* El uso de los datos: `training` o `evaluation`.

El agente obtiene el tenant, la suscripción, el grupo de recursos, la cuenta de
almacenamiento y el contenedor desde tu sesión autenticada de Azure CLI. Verifica
estos valores con los metadatos de Azure de la cuenta de almacenamiento, no con tu
suscripción activa de la CLI. Si no puede verificarlos, se detiene y te indica qué
falta en lugar de adivinar.

## Antes de comenzar

Conecta el agente al endpoint MCP de tu equipo:

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

Inicia sesión en el directorio y la suscripción que contienen la cuenta:

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

Tu identidad debe poder asignar roles en el contenedor, por ejemplo mediante
**Owner** o **User Access Administrator**.

> [!NOTE]
>
> Los roles de suscripción de Azure y los roles de directorio de Microsoft Entra
> son independientes. Ser Owner permite asignar RBAC, pero no necesariamente
> aprobar una aplicación empresarial.

## Pídeselo al agente

```text theme={null}
Conecta https://customerdata.blob.core.windows.net/training/incoming/
a mi proyecto de Fastino "support-classifier" como datos de entrenamiento.

Usa mi sesión actual de Azure CLI. Concede únicamente Storage Blob Data Reader
sobre este contenedor, prueba el conector, sincronízalo, espera a que termine e
informa de los datasets resultantes. No inicies entrenamiento.
```

## Resultados de la sincronización

La sincronización convierte y valida los archivos del prefijo seleccionado antes
de publicar datasets. Una sincronización correcta enumera sus datasets en el
informe.

* Si un archivo no supera la validación, la sincronización falla y no publica
  ningún dataset. El informe enumera los archivos que debes revisar. El agente te
  transmite esos fallos y te pregunta antes de excluir archivos o cambiar el
  prefijo.
* Si la conversión de documentos alcanza un límite de frecuencia, el informe se
  marca como `partial` (los datasets enumerados se pueden usar y faltan algunos
  archivos) o `transient` (no se publicó nada nuevo) e incluye `retryable_files`.
  Pide al agente que vuelva a sincronizar sin repetir la prueba ni cambiar el
  prefijo.
* La sincronización es opcional si delegas un ajuste fino mediante Fastino MCP.
  Después de aprobar el plan, el agente de ajuste fino puede inspeccionar y
  preprocesar los archivos sin procesar del contenedor conectado.

## Consentimiento y seguridad

Para conectar el primer contenedor de un tenant de Azure, alguien de ese tenant
debe abrir `setup.consent_url` en un navegador para crear la aplicación
empresarial de Fastino. El agente no puede aprobar el consentimiento en tu
nombre. Si la aplicación ya existe, no hace falta repetir este paso. Un usuario
solo puede aprobarlo si la política del tenant permite dar consentimiento a
esta aplicación. Algunos tenants restringen las aplicaciones externas sin
editor verificado. Si se bloquea el consentimiento del usuario, entrega
`setup.admin_consent_url` a un **Cloud Application Administrator** o
**Global Administrator** de Entra. Ser Owner de la suscripción no sustituye
este permiso del directorio.

El consentimiento no concede acceso a los blobs. Tras probar el conector, un
Owner o User Access Administrator asigna **Storage Blob Data Reader** al
contenedor elegido. Cada contenedor adicional necesita su propia asignación de
rol, pero no un nuevo consentimiento. El cliente nunca tiene que modificar el
registro de la aplicación de Fastino.

Fastino no acepta claves de cuenta, tokens SAS, secretos de cliente ni
certificados del cliente. En ejecución usa su propia identidad con certificado y
el rol **Storage Blob Data Reader**, limitado al contenedor seleccionado.

## Solución de problemas

| Estado o error de Microsoft | Significado | Acción |
| - | - | - |
| `consent_missing` | La aplicación empresarial de Fastino no existe en el tenant | Abre la URL de consentimiento; usa un administrador solo si la política lo exige |
| `AADSTS1003031` | La aplicación Entra de Fastino está mal configurada; puede aparecer durante el consentimiento o como `provider_error_code` con `consent_missing` | Contacta con el soporte de Fastino; no cambies el registro de aplicaciones de tu tenant ni el RBAC de Blob |
| `role_missing` | Hay consentimiento, pero falta RBAC | Ejecuta el comando de rol devuelto y vuelve a probar |
| `container_missing` | Las coordenadas de almacenamiento no coinciden | Pide al agente que redescubra el recurso desde la URL |
| `unavailable` | Azure o Fastino no pudo completar la prueba | Reintenta la prueba; contacta con el soporte de Fastino si sigue fallando |

La propagación de RBAC puede tardar varios minutos. Reintenta antes de crear otro
conector.


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