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.

Herramienta

filmo_ai_ask

Escrituraai:ask

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

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

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

generado desde el esquema

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.

Argumentos

questionstringObligatorio

Pregunta en lenguaje natural sobre los datos de tu cuenta. Obligatoria.

Límites: longitud mín. 1, longitud máx. 4000

webSearchbooleanpredeterminado:false

Permite también buscar en la web para responder. Por defecto es false: solo se consultan los datos de la cuenta.

modestringpredeterminado:"instant"

Modo de respuesta. Hoy solo "instant" (una sola pasada, sin conversación). Se documenta para que los modos futuros sean aditivos.

Resultado

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

Ver los atributos de data

answerstring

Respuesta en markdown. Cadena vacía cuando needsMoreContext es true.

needsMoreContextboolean

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.

webSearchSourcesobject[]

Fuentes web citadas. Vacío si no se pidió búsqueda web o si no se usó ninguna.

Mostrar atributos hijos

webSearchSources.urlstring

URL de la fuente consultada.

webSearchSources.titlestring

Título de origen.

webSearchSources.faviconstring

URL del favicon del sitio, para mostrar la fuente.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

Prompts de ejemplo

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.

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.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

Prompts de ejemplo

La misma operación por REST

Páginas relacionadas

Preguntar a la IA sobre tus datos

Escrituras seguras

Errores