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.
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
- Abra VS Code y vaya a la vista de Extensiones (
Ctrl+Shift+X/Cmd+Shift+X). - Busque “Truthlocks MAIP”.
- Haga clic en Instalar.
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 complementotruthlocks/maip.nvim lanzado, con curl disponible en su PATH:
: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: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. UseWEBHOOK_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 sonmaip-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:
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 MAIPdata.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:MLflow, DVC y Delta Lake
Instalemlflow-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ágenestruthlocks/*: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.

