Avanzado

Integraciones

Cómo conectar ArtificialQA con tus agentes de IA, importar/exportar datos y consumir resultados desde tus pipelines.

Tipos de integración

Hoy ArtificialQA se integra con tu ecosistema en tres direcciones:

🤖

Conexión con agentes de IA

Por HTTP/API o por navegador (Playwright). Es el qué se testea.

📤

Importar / Exportar datos

Importar test cases desde Excel/JSON. Exportar reportes a PDF.

🔌

API REST

Disparar runs y leer resultados desde tus propios scripts o pipelines.

1. Conexión con agentes de IA

HTTP / API (Pro y Enterprise)

Para agentes de IA que exponen un endpoint propio. Es la forma más limpia y eficiente cuando el agente de IA tiene un API.

Soporta Bearer Token, API Key (en header o query), Custom Headers.
Body templating: indicas dónde se inyecta el mensaje del usuario.
Response mapping: indicas de qué campo extraer la respuesta del bot.
Funciona con cualquier framework (LangChain, LlamaIndex, Rasa, etc.) siempre que respondan por HTTP.

Browser / Playwright (todos los planes)

Para agentes de IA embebidos en páginas web. ArtificialQA corre Chromium headless en sus workers en la nube:

Soporta widgets de chat embebidos (incluyendo plataformas comerciales).
Soporta páginas con login: defines la secuencia de Login Steps.
Corre en headless en nuestros workers en la nube.
Guarda en el snapshot del Run el HTML capturado, los selectores usados y el response del DOM, para inspección posterior.

2. Importar / Exportar datos

Importar test cases

Excel (.xlsx): descargas el template, lo llenas, lo subes. Ideal cuando el equipo de producto te pasa los casos.
JSON: útil para automatizaciones — un script genera el JSON y lo sube vía UI o API.

Los casos importados quedan en la vista de revisión antes de incorporarse, igual que los generados con IA: puedes editarlos y decidir si van a tu catálogo de Test Cases, a una Test Suite específica, o se descartan.

Exportar reportes

PDF — desde el Evaluation Report, botón PDF Report.
API — consumir los resultados estructurados en JSON.

3. API REST

Disponible en el plan Enterprise. La API REST permite operar la plataforma desde tus propios scripts o pipelines.

Casos de uso típicos

Disparar un run cada vez que se hace un deploy del agente de IA.
Leer el resultado del run y bloquear el deploy si el score cae bajo cierto umbral.
Consolidar runs de varios agentes de IA en un dashboard externo.
Generar test cases programáticamente y subirlos.

Operaciones principales

Listar y crear Test Cases.
Listar y crear Test Suites.
Listar Test Plans, disparar un Run, consultar el estado.
Obtener resultados y scores de un Run evaluado.

📚 Documentación detallada de la API. La referencia técnica con todos los endpoints, schemas y ejemplos se está consolidando para publicación. Mientras tanto, contáctanos en artificialqa.com y te facilitamos el acceso.

Lo que está en el roadmap

Para ser transparentes: hay integraciones que no están todavía y que recibimos como pedido frecuente:

Webhooks para notificar fin de Run.
Integración nativa con Slack / Teams.
Integración nativa con Jira u otros gestores de tickets.
SDKs oficiales (Python, Node.js).

Si alguna es bloqueante para ti, escríbenos — el roadmap se prioriza con feedback real de clientes.

Próximo paso

Si vas a manejar datos sensibles o tienes requerimientos de compliance, la sección de Seguridad y compliance es la siguiente parada.