iGPT
API de Inteligencia de Contexto que devuelve respuestas estructuradas y citadas a partir de hilos de correo electrónico, archivos adjuntos y documentos de Google Drive en una sola llamada a la API.
Documentación
Contexto de correo electrónico que tu agente realmente puede usar
Una llamada API. Decisiones, tareas, responsables y próximos pasos de conversaciones de correo electrónico reales.
---La mayoría de los agentes fallan en el momento en que les das correo electrónico.
Los hilos son desordenados. Las respuestas duplican todo. Las decisiones están enterradas en 20 mensajes. Los archivos adjuntos se mencionan pero viven en otro lugar.
Entonces, en lugar de "¿qué pasó en este trato?", tu agente recibe texto sin procesar y respuestas incorrectas con confianza.
iGPT arregla esa capa. Conectas una bandeja de entrada, haces una pregunta y obtienes respuestas estructuradas que tu agente realmente puede usar. Sin análisis MIME. Sin reconstrucción de hilos. Sin manejo de archivos adjuntos. Solo un prompt, un esquema y una respuesta que tu código puede usar.
Proveedores compatibles: Gmail, Outlook y cualquier proveedor IMAP. Se admite múltiples proveedores por usuario.
Lo que obtienes
No resúmenes. Respuestas estructuradas sobre las que tu agente puede construir.
Pregunta: "¿Qué está sin resolver con Northstar Logistics?"
{
"open_items": [
{
"type": "commitment",
"description": "Send completed security questionnaire",
"owner": "us",
"promised_on": "2026-03-05",
"status": "overdue",
"source": "email from David Park, March 5"
},
{
"type": "unanswered_question",
"description": "Data residency requirements for EU operations",
"raised_by": "Northstar legal team",
"date": "2026-02-28",
"status": "open"
}
],
"attachments_referenced": ["Security_Audit_v2.pdf", "Q3_Rollout_Draft.xlsx"],
"relationship_summary": "Active prospect for 4 months. Two open commitments from our side are overdue."
}
Cada campo está validado por esquema. Cada hallazgo cita el hilo de correo electrónico de origen. Tiempo de respuesta típico: ~3 segundos, incluso en bandejas de entrada grandes.
Inicio rápido
from igptai import IGPT
igpt = IGPT(api_key="IGPT_API_KEY", user="user_123")
res = igpt.recall.ask(
input="Open action items from this week with owners and due dates",
output_format={
"strict": True,
"schema": {
"type": "object",
"properties": {
"action_items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {"type": "string"},
"owner": {"type": "string"},
"due_date": {"type": "string"}
}
}
}
}
}
}
)
pip install igptai # Python
npm install igptai # Node.js
Obtén tu clave API en igpt.ai/hub/apikeys o prueba consultas en el Playground primero.
Lo que puedes construir
- Detecta tratos que se enfrían antes de que tu CRM muestre algo
- Mantén tu CRM sincronizado con lo que realmente sucedió en el correo electrónico, no con lo que alguien recordó registrar
- Extrae tareas con responsables correctos y fechas de vencimiento en Jira, Asana o Notion
- Crea agentes de preparación de reuniones que obtengan el historial completo de relaciones, compromisos abiertos y preocupaciones conocidas
- Evalúa la salud del cliente a partir del tiempo de respuesta del correo electrónico, cambios de tono y señales de participación
- Muestra hilos que esperan una respuesta donde alguien hizo una pregunta y nunca recibió respuesta
Por qué el correo electrónico es difícil para los agentes
Los hilos de correo electrónico contienen contenido duplicado de 4 a 5 veces por las citas anidadas. Los participantes están enterrados en los encabezados sin forma de saber quién se comprometió con algo versus quién solo fue copiado (CC). Los archivos adjuntos se mencionan en la conversación ("mira los números en la fila 17") pero viven en una capa de datos completamente separada que la mayoría de las integraciones ignoran por completo.
La mayoría de los equipos terminan construyendo su propio analizador MIME, lógica de reconstrucción de hilos, pipeline de deduplicación y modelo de permisos antes de escribir una sola línea de lógica de agente. iGPT maneja todo eso en una sola llamada API.
Cómo funciona
Conecta una cuenta de correo electrónico mediante OAuth → Pregunta con lenguaje natural o un esquema JSON → Recibe resultados estructurados y citados.
Lo que iGPT maneja internamente: análisis de hilos, deduplicación de texto citado, detección de roles de participantes, extracción de archivos adjuntos, citas de fuentes, aislamiento de datos por usuario.
Conecta una cuenta de correo electrónico
from igptai import IGPT
igpt = IGPT(api_key="IGPT_API_KEY")
res = igpt.connectors.authorize(user="user_123", service="spike", scope="messages")
print("Open this URL to authorize:", res.get("url"))
Pregunta con salida estructurada
igpt = IGPT(api_key="IGPT_API_KEY", user="user_123")
res = igpt.recall.ask(
input="Extract key risks, decisions, and next steps from this week.",
output_format={
"strict": True,
"schema": {
"type": "object",
"properties": {
"risks": {"type": "array", "items": {"type": "string"}},
"decisions": {"type": "array", "items": {"type": "string"}},
"next_steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"action": {"type": "string"},
"owner": {"type": "string"},
"due_date": {"type": "string"}
}
}
}
}
}
}
)
Busca en el correo electrónico
res = igpt.recall.search(
query="Q1 budget discussion",
date_from="2026-01-01",
date_to="2026-03-31"
)
🔒 Seguridad
iGPT opera con datos de comunicación sensibles. La seguridad se aplica mediante arquitectura, no suposiciones.
- Aislamiento por usuario — Las fuentes de datos, índices y contexto de cada usuario están físicamente separados, no filtrados.
- Cifrado — Cifrado AES en reposo y en tránsito. Solo HTTPS.
- Sin retención de prompts — Los prompts y las salidas generadas se descartan después de la ejecución.
- Ejecución controlada — Los pipelines deterministas previenen la inyección de prompts.
- Auditabilidad — Cada solicitud produce metadatos para rastreo sin registrar contenido sin procesar.
Para el modelo de seguridad completo, consulta docs.igpt.ai/docs/security.
Más ejemplos
Node.js
import IGPT from "igptai";
const igpt = new IGPT({ apiKey: process.env.IGPT_API_KEY, user: "user_123" });
const res = await igpt.recall.ask({
input: "List open action items from this week. Include owner and due date."
});
console.log(res);
Transmisión
stream = igpt.recall.ask(input="Stream the answer in chunks.", stream=True)
for chunk in stream:
print(chunk)
Manejo de errores
El SDK nunca lanza excepciones. Los errores se devuelven como objetos:
res = igpt.recall.ask(input="...")
if res is not None and res.get("error"):
print("Error:", res["error"])
else:
print(res)
🔗 Relacionados
- iGPT Python SDK —
pip install igptai - iGPT Node.js SDK —
npm install igptai - iGPT Sales Skills — 7 flujos de trabajo de ventas listos para usar
- API Documentation — Referencia completa de endpoints
- Playground — Prueba consultas interactivamente antes de escribir código
- Get API Key — Crea tu clave y comienza a construir
Contribuciones
¿Preguntas, errores o solicitudes de funciones? Abre un issue o contacta en hello@igpt.ai.
Licencia
MIT