*MCP › Referencia › Plataforma › IA*

# Preguntar a la IA sobre tus datos

> Responde en lenguaje natural a una pregunta sobre los datos de tu cuenta, y opcionalmente también busca en la web.

> **Requiere confirmación humana:** Pon esta herramienta en la lista de «preguntar antes de ejecutar» de tu cliente. Las anotaciones son pistas que declara el servidor, no garantías: no decidas la aprobación solo por `destructiveHint`.

> **Anotación del servidor:** Gasta créditos de IA de la cuenta y puede buscar en la web: un vector de inyección de instrucciones más fuerte que los campos de texto libre. Por eso está anotada como no de solo lectura.

NUNCA escribe nada: el motor se ejecuta sin ninguna herramienta de escritura cargada, y lo que puede leer está acotado por la barrera de permisos del propietario de la clave de API, tabla por tabla. Consume créditos de IA de la cuenta: sin cuota responde 402 addon_required sin llegar a consultar al modelo. Puede tardar decenas de segundos en preguntas que encadenan varias consultas; si `needsMoreContext` pasa a true, la respuesta viene vacía y debes reformular con más detalle en lugar de reintentar lo mismo.

HERRAMIENTA `filmo_ai_ask` · `ai:ask` · 120/min · Puede requerir un add-on · Anotación del servidor: Mundo abierto · Requiere confirmación humana

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `question` | string | Sí | Pregunta en lenguaje natural sobre los datos de tu cuenta. Obligatoria. |
| `webSearch` | boolean | No | Permite también buscar en la web para responder. Por defecto es false: solo se consultan los datos de la cuenta. = `false` |
| `mode` | string | No | Modo de respuesta. Hoy solo "instant" (una sola pasada, sin conversación). Se documenta para que los modos futuros sean aditivos. = `"instant"` |

## Resultado

En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`.

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `answer` | string | Respuesta en markdown. Cadena vacía cuando needsMoreContext es true. |
| `needsMoreContext` | boolean | True cuando la IA terminó sin poder responder y necesita más contexto. En ese caso `answer` viene vacío: reformula la pregunta con más detalle en lugar de reintentarla tal cual. |
| `webSearchSources` | object[] | Fuentes web citadas. Vacío si no se pidió búsqueda web o si no se usó ninguna. |
| `webSearchSources.url` | string | URL de la fuente consultada. |
| `webSearchSources.title` | string | Título de origen. |
| `webSearchSources.favicon` | string | URL del favicon del sitio, para mostrar la fuente. |

*Llamada · filmo_ai_ask*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_ai_ask",
    "arguments": {
      "question": "<question>"
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": {
      "answer": "<answer>",
      "needsMoreContext": true,
      "webSearchSources": [
        {
          "url": "https://example.com",
          "title": "Example",
          "favicon": "<favicon>"
        }
      ]
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}
```

## Prompts de ejemplo

*Prompt*

```text
Pregunta a la cuenta: ¿qué clientes alquilaron más el trimestre pasado?
```

## La misma operación por REST

Esta herramienta ejecuta [`POST /api/v1/ai/ask`](https://docs.filmo.io/es/rest-api/endpoint-reference/ai/ask-the-ai-about-your-data).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/ai/filmo-ai-ask  
Última actualización: 2026-10-25