Perplexity para investigación técnica: modos, Proyectos y API

Perplexity responde una pregunta técnica buscando, escribiendo una síntesis breve y adjuntando fuentes numeradas. Eso es útil cuando estás depurando una cadena de error o comparando dos diseños. No es un sustituto de la página del proveedor a la que apunta la cita. Este laboratorio usa los propios nombres del producto tal como estaban en el centro de ayuda y los docs de API leídos en octubre de 2026.

Qué devuelve una búsqueda en realidad

El artículo de ayuda «How does Perplexity work» describe tres movimientos: buscar en la web, comprimir los bits relevantes en una respuesta y adjuntar citas numeradas que enlazan a los originales. Las preguntas de seguimiento permanecen en la misma sesión.

Pro Search es el pase más profundo. El artículo de Pro dice que no es un interruptor. Cuando buscas, Perplexity lo aplica automáticamente si tu plan lo incluye, hasta el límite de tu plan. Puedes dejar el modelo en Best, que elige un modelo por pregunta, o elegir un modelo en el menú de modelos. La página de ayuda de Pro, como se leyó para este artículo, nombra ejemplos incluyendo GPT-5.2, Claude Sonnet 4.6 y Gemini 3.1 Pro. Los ejemplos del artículo de Pro Search no son idénticos. Trata el menú en tu cuenta como la lista, y esos nombres como ilustraciones de las páginas de ayuda, no como un contrato.

El mismo artículo «how it works» describe Research como un bucle más largo: muchas búsquedas, muchas fuentes e un informe que dice que llega en alrededor de dos a cuatro minutos. Úsalo cuando la pregunta es un estudio de diseño. Usa una búsqueda normal cuando necesitas un hecho y un enlace.

La forma del prompt para preguntas cotidianas es el mismo hábito que la chuleta de prompting de ChatGPT: nombra el objeto, la restricción y lo que la respuesta debe citar.

Focus, sources y modos de búsqueda

El artículo de ayuda de Pro Search dice que el rastreo depende del focus que selecciones, y da Web, Academic, Finance y Files como ejemplos. También dice que puedes reducir a tipos de contenido como Academic, Finance o tus propios archivos.

Enterprise Pro es diferente. La colección del centro de ayuda establece que Focus fue reemplazado por Choose sources. El artículo de Internal Knowledge Search lista las opciones: Web, Org Files, Web + Org Files o None. Deselecciona Web cuando deseas solo los archivos de la organización. Deselecciona ambos cuando deseas una respuesta que no use esas fuentes.

Finance focus no es «la web completa, pero sobre dinero.» La colección de datos premium del centro de ayuda lista conectores como FactSet, PitchBook, Morningstar, Daloopa y otros, algunos de los cuales requieren tu propia autorización. Una respuesta Finance aún puede perder un archivo. Para cualquier cosa que pondrías en un documento de diseño, abre la cita.

En la API, el campo antiguo search_mode de Sonar aceptaba web, academic y sec. La guía de migración dice que academic no tiene un equivalente directo en la API de Agente. Usa la herramienta web_search con un filtro de dominio y di en las instrucciones que deseas fuentes revisadas por pares o primarias. Para sec, la guía dice que uses Finance Search o web_search limitada a fuentes SEC. No sigas enviando search_mode: academic en código nuevo y esperes el comportamiento antiguo.

Proyectos, no un segundo tipo de chat

El artículo de ayuda de Projects describe un Proyecto como un espacio de trabajo persistente: búsquedas, tareas de Computer, archivos, instrucciones y herramientas conectadas, compartidas con colaboradores. Los archivos en el Proyecto son contexto para ese trabajo. Los viewers y editores pueden ver archivos. El artículo dice que solo los editores pueden editar, eliminar o cargar.

La ayuda de Enterprise agrega los bits prácticos. Los archivos que cargas a un Proyecto personal no son automáticamente parte del repositorio de la organización. Puedes establecer instrucciones personalizadas para cómo deben escribirse las respuestas, y puedes elegir un modelo para ese Proyecto. Los ejemplos de modelos del artículo de empresa incluyen GPT-5 y Claude 4.5 Sonnet. Esos ejemplos están ligeramente en desacuerdo con la lista de modelos de la página de Pro. Úsalos como evidencia de que el menú cambia, no como una alineación para memorizar.

Un Proyecto de depuración es un buen ajuste para un servicio: las notas del último incidente, el fragmento de config y una instrucción como «cita la cadena de error, luego lista solo las causas que aparecen en los archivos adjuntos o en una cita.» Un Proyecto de arquitectura es la misma idea con ADRs y una restricción como «prefiere la versión principal actual y di cuando una cita es anterior a 18 meses.»

Archivos y qué sucede con ellos

El artículo de ayuda de carga de archivos dice que adjuntas archivos desde la barra de búsqueda con + Attach, o arrastrando un archivo o carpeta. Dice que los archivos textuales (texto plano, código, PDFs), imágenes, audio y video están dentro del alcance. El audio y video se transcriben para que el habla se pueda buscar. Los archivos cortos se pueden usar en su totalidad. Un archivo largo se reduce a las partes que el sistema trata como más relevantes para la pregunta. Si la respuesta pierde una sección que sabes que está en el PDF, la extracción es el primer sospechoso. Pregunta de nuevo con la página o encabezado nombrado, o pega esa sección.

El artículo de Internal Knowledge Search, en su comparación de carga versus el repositorio de la organización, dice que puedes adjuntar hasta cinco archivos por hilo, que esos archivos son para esa sesión, y que se eliminan después de siete días. Ese es un límite de esa página de ayuda, como se leyó en octubre de 2026. Los archivos del repositorio de la organización y los archivos del Proyecto son la opción durable. El mismo artículo dice que los administradores de la organización pueden cargar hasta 500 archivos al repositorio de la organización. No planifiques una carga personal como un archivo.

Citas que puedes verificar

Cada respuesta que los artículos de ayuda describen incluye enlaces de vuelta a las fuentes. Las citas en línea de archivos internos, en la página de empresa, se pueden abrir o descargar desde la referencia. Ese es el valor completo del producto para el trabajo de operaciones. Un párrafo sin cita es un borrador. Un párrafo con una cita es aún un borrador hasta que abras la URL.

Verifica tres cosas en la página de origen:

• La página es la documentación del propio proveedor, no una repostaje.
• La oración que podrías copiar está realmente en esa página.
• La versión y la fecha coinciden con el clúster o CLI que ejecutas.

Si la cita es un foro, dilo en tus notas. Si dos citas están en desacuerdo, mantén el documento primario más nuevo. Perplexity no te dirá de manera confiable cuál cambió la semana pasada.

Prompts para depuración e investigación de diseño

Escribe el prompt para que una cita pueda falsificarlo. Incluye el texto de error exacto, la versión y el resultado que deseas.

Depuración:

Kubernetes 1.31. El evento kubelet dice "Failed to pull image" y la razón del contenedor es ImagePullBackOff.
Search current container-runtime and registry docs.
Return: the three most common causes, each with the doc URL and the sentence you used.
If a cause is not in a citation, omit it.

Arquitectura:

Compare external-dns and a cloud-controller Service load balancer for a single regional cluster.
Use docs from the last 18 months.
Return a table: who creates the DNS record, what is stored in the cluster, and what fails closed.
Cite every cell.

Agrega «no recomiendes un flag que no puedas citar» cuando estés a punto de pegar la respuesta en un runbook. Para una investigación de varios pasos que preferirías automatizar, un agente con herramientas es un sistema diferente. Ve qué es IA agentiva. Llamar a Perplexity desde un flujo de trabajo es un paso HTTP en primer flujo de trabajo n8n, usando la API a continuación, no un raspado del sitio web.

API: nombres de Sonar, llamadas de API de Agente

A partir de la guía de migración leída en octubre de 2026, la compatibilidad de Sonar Chat Completions terminó el 27 de septiembre de 2026. Las solicitudes Sonar síncronas y de flujo continuo aún responden. Se están reformulando en solicitudes de API de Agente, lanzadas por modelo. Las solicitudes Sonar asincrónicas no se reformulan. Mueve esas a la API de Agente’s modo en segundo plano.

Los ids de modelo Sonar que la referencia de API más antigua enumeraba eran sonar, sonar-pro, sonar-reasoning-pro y sonar-deep-research. La guía los asigna a niveles de esfuerzo:

Las nuevas solicitudes van a POST https://api.perplexity.ai/v1/agent con Authorization: Bearer y PERPLEXITY_API_KEY. El cliente oficial de Python es perplexity.Perplexity, luego client.responses.create. Los presets de esfuerzo rellenan herramientas. Las notas de migración dicen que tools: [] no borra las herramientas de un nivel de esfuerzo, y que max_tool_calls: 0 es la forma sin rodeos de detener las llamadas de herramientas.

curl https://api.perplexity.ai/v1/agent \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"effort\":\"low\",\"input\":\"Why does a Kubernetes Ingress return 404 after a canary deploy? Cite the docs you used.\"}"

import os
from perplexity import Perplexity

client = Perplexity()
response = client.responses.create(
    effort="low",
    input="Why does a Kubernetes Ingress return 404 after a canary deploy? Cite the docs you used.",
)
print(response.output_text)

La clave es la variable de entorno que el cliente espera. No la pongas en el script. La respuesta de la API de Agente es una lista de pasos: un elemento search_results y un elemento message, no el antiguo Sonar choices más un array citations de nivel superior. Lee las URLs de search_results y verífícalas.

Los filtros de dominio se movieron a los filters de la herramienta web_search, bajo los mismos nombres (search_domain_filter, recencia, fecha). search_mode: academic no viene. La API de Agente también documenta una caja de arena de código y MCP junto a la búsqueda web. MCP como protocolo se explica en servidores MCP explicados. Una lista de modelos de un proveedor diferente, si crecas más allá de una única API de investigación, está en la chuleta de herramientas Gemini.

Cuándo no confiar en él

No confíes en él para un flag, un predeterminado o una cuota que no has abierto en el sitio del proveedor. La cita puede ser un blog secundario que parafraseó un predeterminado antiguo.

No confíes en él para un PDF largo que no verificaste. El artículo de ayuda de carga dice que los archivos largos se reducen a partes relevantes.

No confíes en un nombre de modelo en una captura de pantalla antigua. Dos artículos de ayuda oficial, leídos la misma semana, usaron diferentes nombres de modelo de ejemplo.

No envíes secretos, datos de clientes o un diseño sin publicar a un hilo de consumidor si la regla de tu empresa es que los prompts no son una tienda privada. Compartir Proyectos significa que otros miembros con acceso pueden ver los archivos. El artículo de empresa dice que los viewers pueden ver archivos.

No mantengas una integración Sonar asincrónica. Ese camino es el que la guía de migración dice que ya no es compatible.

La salida de investigación es una lista de lectura con un resumen en borrador. La decisión aún pertenece a la persona que abre los enlaces.

Preguntas frecuentes

¿Qué pasó con la API Sonar de Perplexity?

La compatibilidad de Sonar Chat Completions terminó el 27 de septiembre de 2026. La guía de migración de Perplexity dice que las llamadas Sonar síncronas y de flujo continuo aún se ejecutan porque se están reescribiendo como solicitudes de API de Agente, gradualmente por modelo. Las llamadas Sonar asincrónicas no se reescriben y ya no son compatibles. El nuevo trabajo debe llamar a la API de Agente.

¿Todavía son una característica los Espacios de Perplexity?

La página del centro de ayuda leída para este artículo describe Proyectos, no un producto llamado Espacios. Un Proyecto contiene búsquedas, archivos, instrucciones y herramientas conectadas para las personas con las que lo compartes. La ayuda Enterprise también dice que Focus fue reemplazado por Choose sources para usuarios de Enterprise Pro.

¿Una cita numerada significa que la oración es correcta?

Significa que el producto adjuntó una fuente. Abre el enlace y verifica que la página establece la afirmación. Las cargas largas se resumen de partes extraídas, no siempre se leen en su totalidad. El centro de ayuda dice que los archivos cortos se pueden analizar en su totalidad y los archivos largos se reducen a las partes que el sistema trata como relevantes.

¿Qué nivel de esfuerzo de la API de Agente reemplaza Sonar Deep Research?

La guía de migración asigna Sonar Deep Research al esfuerzo high. Asigna Sonar y Sonar Pro a fast, y Sonar Reasoning Pro a low. Apunta a xhigh cuando deseas el nivel más profundo en ese alineación. El modo de búsqueda académica no tiene un campo directo. Filtra dominios web_search y dilo en las instrucciones.