Saltar al contenido principal

Integraciones MAIP

El Protocolo de Identidad de Agente de Máquina (MAIP) incluye integraciones que incorporan la identidad del agente, los recibos y la puntuación de confianza en sus flujos de trabajo existentes. La evidencia local, el envío de recibos alojados y la verificación de firmas son operaciones separadas. Configure y pruebe la integración que utiliza; la instalación por sí sola no crea una pista de auditoría completa.
Requisitos previos: Necesita una cuenta de Truthlocks con una clave API y al menos un agente registrado. Consulte la guía de identidad de la máquina para registrar su primer agente.
Explore las integraciones disponibles en el Centro de integraciones. Los enlaces están agrupados por SDK, marco de IA, editor y herramienta de colaboración.

Herramientas para desarrolladores

Extensión de VS Code

Un panel lateral para explorar recibos, generar recibos desde su editor y ver datos de confianza. Instálelo desde el Visual Studio Marketplace. Qué hace:
  • Navegar y buscar recibos MAIP desde la barra lateral
  • Generar recibos de cambios de código directamente desde el editor
  • Ver puntuaciones de confianza del agente y cadenas de recibos
Instalación:
  1. Abra VS Code y vaya a la vista de Extensiones (Ctrl+Shift+X / Cmd+Shift+X).
  2. Busque “Truthlocks MAIP”.
  3. Haga clic en Instalar.
Alternativamente, instale desde la línea de comandos:
Después de la instalación, abra el panel lateral de MAIP e ingrese su clave API y ID de agente para conectarse.

Plugin de JetBrains

Integración de MAIP para IntelliJ, PyCharm y WebStorm con las mismas capacidades de navegación y generación de recibos que la extensión de VS Code.

Complemento de Neovim

Instale el complemento truthlocks/maip.nvim lanzado, con curl disponible en su PATH:
Use :MAIPListAgents, :MAIPCreateReceipt, :MAIPListReceipts, :MAIPVerifyReceipt, :MAIPShowTrust y :MAIPDashboard. Los metadatos del recibo son no es una firma verificada. Los recibos de confirmación automáticos son opcionales y observan los compatibles eventos de confirmación completados; no hay opción auto_receipt para guardar en esta versión. Consulte el README versionado para Telescope configuración y los límites actuales de las pruebas interactivas.

Servidor MCP

Instale el ejecutable en la máquina que ejecuta su host MCP:
Suministre las credenciales a través de la configuración segura del host. Utilice una clave y un agente del mismo entorno. Pida al anfitrión que enumere las herramientas disponibles, luego use maip_list_agents, maip_list_receipts y maip_verify_receipt. Una firma positiva el resultado requiere valid: true, signature_verified: true y verdict: "VALID". La verificación de transparencia es un resultado separado. Las escrituras no se reintentan automáticamente.

Colaboración en equipo

Las integraciones de Slack, Linear y Notion requieren su propia aplicación/espacio de trabajo real credenciales además de la autenticación de Truthlocks. Su proceso completo de proveedor a recibo la aceptación aún está pendiente. No trate la disponibilidad de la fuente, las pruebas locales o un Clave API de Truthlocks como prueba de que un espacio de trabajo externo está conectado. Revise el README del paquete fuente para conocer los permisos y la configuración del proveedor: Slack, Linear, Notion. Utilice un espacio de trabajo de prueba dedicado antes de habilitar el procesamiento de eventos reales.

Configuración y validación de Slack

Slack es una instalación de origen, no un paquete npm publicado de @truthlocks/maip-slack. Su autenticación de bot y una presentación autorizada de mensajes de prueba pasaron el proveedor cheques. Los flujos de trabajo completos de comandos de barra para usuarios personales y eventos alojados permanecen bajo validación. Siga el README de Slack para la compilación revisada y todas las configuraciones requeridas. Vincule la aplicación a SLACK_TEAM_ID y a SLACK_ALLOWED_USER_IDS personales explícitos. Use MAIP_AGENT_ID de un agente Truthlocks registrado existente para la creación; un ID de miembro de Slack no es una identidad de máquina. Suministre una clave de sandbox y https://sandbox-api.truthlocks.com/v1 durante la evaluación. Los comandos están registrados en la configuración de la aplicación de Slack. Tanto el modo HTTP como el modo Socket proporcionan /webhook/maip, pero el alojamiento del oyente no suscribe automáticamente los eventos de Truthlocks a él. Las aprobaciones de delegación permanecen en la revisión autenticada de Console. Protección de reproducción local es local al proceso; la entrega de producción necesita un seguimiento ascendente duradero.

Configuración y validación de Notion

Notion es un paquete de origen privado, no una instalación de npm. Aceptación real de QA creó una página secundaria y esquemas de base de datos, insertó un recibo de espacio de trabajo existente, repitió la sincronización sin duplicar esa página y verificó la lectura del proveedor. La automatización alojada continua y la recuperación duradera permanecen en validación. Conecte solo la página deseada usando el menú ••• → Conexiones de Notion. Siga las README de Notion para inicializar bases de datos una vez y reutilizar sus IDs. Use WEBHOOK_SECRET con el contrato HMAC/marca de tiempo versionado; las solicitudes sin firmar son rechazadas. Estado del recibo son metadatos, por lo que un recibo completado no verifica automáticamente la noción cuadro Verificado. Utilice la verificación de firma explícita por separado.

CI/CD

Las entradas de la acción MAIP son maip-api-url, maip-api-key y maip-agent-id. Los nombres antiguos api-key y agent-id no son entradas declaradas. Para un revisado extracción de la fuente con su dist/index.js construido, un flujo de trabajo de control de calidad activado explícitamente puede usar este paso:
Esta es una ruta de acción local después de la extracción y compilación, no un Marketplace no verificado etiqueta. Fije las versiones revisadas al distribuir la acción. Verifique/comente la publicación requiere permisos deliberados de GitHub y aceptación separada; nunca exponga secretos a flujos de trabajo de bifurcaciones no confiables. Consulte el README de la acción.

Conectores de modelos de IA

Los “wrappers” de Python capturan los eventos emitidos a través de la integración configurada. Los hashes locales no son firmas de servidor. Las credenciales del proveedor, las credenciales de Truthlocks y el envío alojado se configuran por separado; inspeccione los metadatos que envía y no asuma que el “hashing” elimina las obligaciones de privacidad.

Marcos de trabajo admitidos

Ejemplo completo de LangChain local (sin solicitud alojada):
payload_hash describe la evidencia local. Para el envío alojado use MAIPClient.create_receipt y verifique el receipt_id del servidor devuelto; el README de LangChain contiene el ejemplo de envío asíncrono. Para los “hooks” automáticos asíncronos, vacíe y cierre el “wrapper” e inspeccione los resultados del envío antes del apagado. Las llamadas fuera del el “wrapper” configurado no se observan.

Pipelines de datos y ML

Conector Kafka

El conector Go envía las huellas digitales de los mensajes como recibos MAIP data.attestation usando un agente existente. Su cliente HTTP usa /v1/agent-receipts, conserva parcial resultados de lotes, y requiere una firma confirmada para una verificación exitosa. Instale github.com/truthlocks/kafka-maip-connector@v0.1.0 con go get. Consulte la versión y el ejemplo completo. La clave API selecciona el espacio de trabajo y el entorno; un ID de inquilino proporcionado por el llamador sí lo hace no anula la autorización. Los bytes del mensaje y las claves de mensaje sin procesar no se cargan. Los envoltorios de productor/consumidor almacenan los recibos en memoria. Entrega y recepción del intermediario la entrega son operaciones separadas; una escritura exitosa en Kafka no garantiza una el recibo fue retenido. La entrega de auditoría requerida necesita una bandeja de salida de aplicación duradera y manejo explícito de fallas. Consulte la evidencia de lanzamiento antes de usar en producción.

Transmisión de eventos

Instale Go event-stream v0.1.0:
La biblioteca incluye un cliente Redis concreto y interfaces de adaptador para NATS JetStream, EventBridge y Kinesis. Los consumidores que se reconectan a Redis escanean sus propios entradas pendientes antes de nuevos mensajes; el procesamiento fallido permanece sin reconocer. Mantenga los nombres de los consumidores estables en los reinicios. Reclamando el pendiente de otro consumidor las entradas aún requieren un proceso de recuperación explícito. El artefacto publicado pasó una prueba aislada de reinicio/reconocimiento de Redis real y el conjunto completo de Go race. Otros adaptadores de backend requieren implementaciones de cliente reales y autenticadas. Estos adaptadores envolventes de eventos de transporte; no acuñan ni verifican automáticamente firmas MAIP. La generación de recibos de Kafka es un conector separado, descrito anteriormente.
La puerta de enlace independiente no está lista para su implementación: sus fábricas de clientes de backend no están cableados, y ahora se niega a iniciar en lugar de informar no realizados publicaciones como aceptadas. No hay truthlocks_streaming.StreamingGateway lanzado API de Python correspondiente al ejemplo anterior de esta página.
La deduplicación ahora utiliza una caché exacta limitada de identidades de eventos confirmadas, con alcance al inquilino y a la fuente. Las publicaciones fallidas no se almacenan en caché. Los reintentos por defecto son cero; los reintentos explícitos proporcionan una entrega al menos una vez, no garantías de exactamente una vez. El middleware por lotes maneja un evento a la vez, por lo que no puede adivinar los elementos fallidos. de los recuentos agregados. La eliminación de la caché y el reinicio del proceso pueden permitir duplicados. El validador de recibos verifica la estructura y los enlaces hash locales; no es una firma verificador. Mantenga el enrutamiento autenticado, la retención duradera y la validación criptográfica en el diseño de su aplicación.

MLflow, DVC y Delta Lake

Instale mlflow-maip, dvc-maip o delta-lake-maip para los metadatos correspondientes constructores. Estos paquetes producen evidencia estructurada local; instalar uno no hacer de cada operación de marco un recibo alojado firmado. No hay soporte truthlocks_mlflow.TruthlocksPlugin.enable API correspondiente al ejemplo anterior. Utilice los ejemplos locales y alojados completos en los README de origen: MLflow, DVC, Delta Lake. Los metadatos del proveedor y los URI de los artefactos no verifican de forma independiente los bytes del artefacto o probar que ocurrió una operación externa. La verificación de firma alojada no establecer la inclusión en el registro de transparencia a menos que esa verificación separada tenga éxito.

Docker

Los archivos fuente del contenedor no establecen que se haya lanzado una imagen pública o aceptación aprobada. Las imágenes truthlocks/*:latest listadas anteriormente y las combinadas El ejemplo de composición no ha sido verificado como una implementación funcional y no es un inicio rápido compatible. No infiera la disponibilidad de la imagen de esos nombres históricos. Utilice la versión del paquete publicado y su README para cada integración. Si está construyendo un contenedor de una fuente revisada, fije esa revisión y dependencias, suministre secretos a través de su tiempo de ejecución, y pruebe la conexión real del proveedor. Slack adicionalmente requiere sus credenciales de aplicación reales; una clave API de Truthlocks por sí sola es insuficiente. La puerta de enlace de flujo de eventos independiente sigue sin estar disponible como se describió anteriormente.

Próximos pasos

Identidad de máquina

Registra tu primer agente y comprende el protocolo MAIP.

Autorización del agente

Configure ámbitos, sesiones y acceso a herramientas para sus agentes.

Descargas

Encuentre las versiones publicadas de CLI, SDK e IDE y sus instrucciones de instalación.

Centro de integraciones

Explore todas las integraciones por categoría.

Lineal

Autenticación de proveedor real, búsqueda de problemas de SDK y un comentario de recibo con lectura aprobado en un problema de control de calidad explícitamente autorizado. Esto no establece el webhook alojado creación de recibos o sincronización continua. El oyente de origen verifica Linear’s Firma HMAC y marca de tiempo firmada, y restringe los eventos a la organización configurada e IDs de equipo. La automatización de hitos del proyecto permanece no disponible en lugar de emitir evidencia estimada. Consulte la configuración y límites de Linear.