cicora.ai
Especificación de la APIFuentes recientes

Búsqueda web

Recupera fuentes recientes mediante una función `web_search` ejecutada por el cliente y mantén los enlaces separados del texto generado.

Referencia de integración: elige los parámetros y las capacidades disponibles en la configuración de la API de tu cuenta y en el catálogo de modelos de tu entorno.

Describe la función del cliente

Envía `web_search` como herramienta de función estándar en el array tools, como en el ejemplo. El modelo solo solicita la llamada; tu aplicación ejecuta la búsqueda mediante una fuente permitida.

Tras la ejecución, devuelve un resultado normalizado al modelo en un mensaje con rol `tool` y el tool_call_id correspondiente. El texto del modelo no sustituye una fuente: conserva URL, título, fecha y contexto.

Función de búsqueda web ejecutada por el cliente
json
{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "Find current primary sources for this topic."}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "web_search",
      "description": "Search permitted sources for current information.",
      "parameters": {
        "type": "object",
        "properties": {"query": {"type": "string"}},
        "required": ["query"],
        "additionalProperties": false
      }
    }
  }]
}

Respuesta fiable

  • Valida el nombre de la función y el argumento de consulta antes de ejecutar la búsqueda.
  • Muestra al usuario enlaces cerca de las afirmaciones cuando el flujo requiera verificación.
  • Restringe dominios o la tarea en el producto cuando lo exija la política de tu organización.

Coste y registro

Registra el gasto de búsqueda en tu ejecutor de funciones por separado de los tokens del modelo.

No repitas automáticamente la búsqueda tras una salida parcial: determina primero qué fuentes han llegado ya y qué vio el usuario.