Zum Hauptinhalt springen

MAIP-Integrationen

Das Machine Agent Identity Protocol (MAIP) wird mit Integrationen geliefert, die Agentenidentität, Belege und Vertrauensbewertung in Ihre bestehenden Workflows bringen. Lokale Nachweise, das Einreichen von gehosteten Belegen und die Signaturverifikation sind separate Vorgänge. Konfigurieren und testen Sie die von Ihnen verwendete Integration; die Installation allein erstellt keinen vollständigen Audit-Trail.
Voraussetzungen: Sie benötigen ein Truthlocks-Konto mit einem API-Schlüssel und mindestens einem registrierten Agenten. Informationen zur Registrierung Ihres ersten Agenten finden Sie im Leitfaden zur Maschinenidentität.
Durchsuchen Sie die verfügbaren Integrationen im Integrations-Hub. Links sind nach SDK, AI-Framework, Editor und Kollaborationstool gruppiert.

Entwicklertools

VS Code-Erweiterung

Ein Seitenbereich zum Durchsuchen von Belegen, zum Generieren von Belegen aus Ihrem Editor und zum Anzeigen von Vertrauensdaten. Installieren Sie es vom Visual Studio Marketplace. Was es tut:
  • MAIP-Belege über die Seitenleiste durchsuchen und suchen
  • Belege für Codeänderungen direkt aus dem Editor generieren
  • Vertrauenswerte von Agenten und Belegketten anzeigen
Installation:
  1. Öffnen Sie VS Code und gehen Sie zur Erweiterungsansicht (Ctrl+Shift+X / Cmd+Shift+X).
  2. Suchen Sie nach „Truthlocks MAIP“.
  3. Klicken Sie auf Installieren.
Alternativ von der Kommandozeile installieren:
Nach der Installation öffnen Sie das MAIP-Seitenleistenfenster und geben Sie Ihren API-Schlüssel und Ihre Agenten-ID ein, um eine Verbindung herzustellen.

JetBrains-Plugin

MAIP-Integration für IntelliJ, PyCharm und WebStorm mit den gleichen Funktionen zum Durchsuchen und Generieren von Belegen wie die VS Code-Erweiterung.

Neovim-Plugin

Installieren Sie das veröffentlichte truthlocks/maip.nvim Plugin, mit curl verfügbar in Ihrem PATH:
Verwenden Sie :MAIPListAgents, :MAIPCreateReceipt, :MAIPListReceipts, :MAIPVerifyReceipt, :MAIPShowTrust und :MAIPDashboard. Metadaten der Quittung sind keine verifizierte Signatur. Automatische Commit-Belege sind Opt-in und beachten unterstützte abgeschlossene Commit-Ereignisse; es gibt in dieser Version keine auto_receipt Speicheroption. Siehe die versionierte README für Telescope Konfiguration und die aktuellen interaktiven Testgrenzen.

MCP-Server

Installieren Sie die ausführbare Datei auf dem Computer, auf dem Ihr MCP-Host läuft:
Geben Sie Anmeldeinformationen über die sichere Konfiguration des Hosts an. Verwenden Sie einen Schlüssel und einen Agenten aus derselben Umgebung. Bitten Sie den Host, die verfügbaren Tools aufzulisten, und verwenden Sie dann maip_list_agents, maip_list_receipts und maip_verify_receipt. Eine positive Signatur Ergebnis erfordert valid: true, signature_verified: true und verdict: "VALID". Die Transparenzprüfung ist ein separates Ergebnis. Schreibvorgänge werden nicht automatisch wiederholt.

Teamzusammenarbeit

Slack-, Linear- und Notion-Integrationen erfordern eine eigene echte Anwendung/einen eigenen Arbeitsbereich Anmeldeinformationen zusätzlich zur Truthlocks-Authentifizierung. Ihre vollständige Anbieter-zu-Beleg- die Annahme noch aussteht. Behandeln Sie die Verfügbarkeit der Quelle, lokale Tests oder eine Truthlocks API-Schlüssel als Nachweis, dass ein externer Arbeitsbereich verbunden ist. Lesen Sie die README-Datei des Quellpakets für Anbieterberechtigungen und -konfiguration: Slack, Linear, Notion. Verwenden Sie einen dedizierten Test-Arbeitsbereich, bevor Sie die Verarbeitung realer Ereignisse aktivieren.

Slack-Einrichtung und -Validierung

Slack ist eine Quellinstallation, kein veröffentlichtes @truthlocks/maip-slack npm-Paket. Die Bot-Authentifizierung und eine autorisierte Testnachrichtenübermittlung wurden vom Anbieter bestanden Prüfungen. Vollständige Slash-Befehle für persönliche Benutzer und gehostete Ereignis-Workflows bleiben unter Validierung. Folgen Sie dem Slack README für den überprüften Build und alle erforderlichen Einstellungen. Binden Sie die App an SLACK_TEAM_ID und explizite persönliche SLACK_ALLOWED_USER_IDS. Verwenden Sie MAIP_AGENT_ID von einem bestehenden registrierten Truthlocks-Agenten zur Erstellung; eine Slack-Mitglieder-ID ist keine Maschinenidentität. Geben Sie einen Sandbox-Schlüssel und https://sandbox-api.truthlocks.com/v1 während der Auswertung. Befehle werden registriert in den Slack-App-Einstellungen. Sowohl HTTP als auch Socket Mode bieten /webhook/maip, aber Hosting des Listeners abonniert Truthlocks-Ereignisse nicht automatisch. Delegationsgenehmigungen bleiben in der authentifizierten Console Überprüfung. Lokaler Replay-Schutz ist prozesslokal; die Produktionslieferung erfordert eine dauerhafte Upstream-Verfolgung.

Notion-Einrichtung und -Validierung

Notion ist ein privates Quellpaket, keine npm-Installation. Echte QA-Akzeptanz eine Unterseite und Datenbankschemata erstellt, einen vorhandenen Arbeitsbereichsbeleg eingefügt, die Synchronisierung wiederholt, ohne diese Seite zu duplizieren, und die Anbieter-Rücklesung überprüft. Kontinuierliche gehostete Automatisierung und dauerhafte Wiederherstellung befinden sich noch in der Validierung. Verbinden Sie nur die gewünschte Seite über das Menü ••• → Verbindungen von Notion. Folgen Sie den Notion README um Datenbanken einmal zu initialisieren und ihre IDs wiederzuverwenden. Verwenden Sie WEBHOOK_SECRET mit dem versionierter HMAC/Zeitstempel-Vertrag; unsignierte Anfragen werden abgelehnt. Empfangsstatus ist Metadaten, daher überprüft ein abgeschlossener Beleg nicht automatisch die Notion Verifiziert-Feld. Verwenden Sie die explizite Signaturverifizierung separat.

CI/CD

Die Eingaben der MAIP-Aktion sind maip-api-url, maip-api-key und maip-agent-id. Die älteren Namen api-key und agent-id sind keine deklarierten Eingaben. Für eine überprüfte Quell-Checkout mit seinem erstellten dist/index.js, einem explizit ausgelösten QA-Workflow können diesen Schritt verwenden:
Dies ist ein lokaler Aktionspfad nach dem Checkout und Build, kein nicht verifizierter Marketplace Tag. Pinnen Sie überprüfte Releases, wenn Sie die Aktion verteilen. Überprüfen/Kommentieren Sie die Veröffentlichung erfordert bewusste GitHub-Berechtigungen und separate Akzeptanz; niemals Geheimnisse preisgeben zu Workflows von nicht vertrauenswürdigen Forks. Siehe die Aktion README.

KI-Modell-Konnektoren

Python-Wrapper erfassen Ereignisse, die über die konfigurierte Integration ausgegeben werden. Lokale Hashes sind keine Serversignaturen. Anbieteranmeldeinformationen, Truthlocks-Anmeldeinformationen und gehostete Übermittlungen werden separat konfiguriert; überprüfen Sie die von Ihnen gesendeten Metadaten und gehen Sie nicht davon aus, dass das Hashing Datenschutzpflichten aufhebt.

Unterstützte Frameworks

Vollständiges lokales LangChain-Beispiel (keine gehostete Anfrage):
payload_hash beschreibt lokale Beweise. Für die gehostete Einreichung verwenden Sie MAIPClient.create_receipt und überprüfen Sie den zurückgegebenen Server receipt_id; die LangChain README enthält das Beispiel für die asynchrone Übermittlung. Für asynchrone automatische Hooks, leeren und Schließen Sie den Wrapper und überprüfen Sie die Übermittlungsergebnisse vor dem Herunterfahren. Aufrufe außerhalb des konfigurierten Wrappers werden nicht beobachtet.

Daten- und ML-Pipelines

Kafka-Konnektor

Der Go-Konnektor übermittelt Nachrichten-Fingerabdrücke als MAIP data.attestation Belege mit einem bestehenden Agenten. Sein HTTP-Client verwendet /v1/agent-receipts, bewahrt teilweise Batch-Ergebnisse und erfordert eine bestätigte Signatur für eine erfolgreiche Verifizierung. Installieren Sie github.com/truthlocks/kafka-maip-connector@v0.1.0 mit go get. Siehe das Release- und vollständige Beispiel. Der API-Schlüssel wählt den Arbeitsbereich und die Umgebung aus; eine vom Aufrufer bereitgestellte Mandanten-ID tut dies Autorisierung nicht überschreiben. Nachrichtenbytes und Roh-Nachrichtenschlüssel werden nicht hochgeladen. Die Producer/Consumer-Wrapper puffern Belege im Speicher. Broker-Zustellung und -Empfang Lieferung sind separate Vorgänge; ein erfolgreicher Kafka-Schreibvorgang garantiert keine Beleg wurde aufbewahrt. Erforderliche Audit-Lieferung benötigt eine dauerhafte Anwendungs-Outbox und explizite Fehlerbehandlung. Konsultieren Sie die Freigabebelege vor der Produktionsnutzung.

Ereignis-Streaming

Installieren Sie Go event-stream v0.1.0:
Die Bibliothek enthält einen konkreten Redis-Client und Adapter-Schnittstellen für NATS JetStream, EventBridge und Kinesis. Redis-wiederverbindende Konsumenten scannen ihre eigenen ausstehende Einträge vor neuen Nachrichten; fehlgeschlagene Verarbeitung bleibt unbestätigt. Halten Sie Konsumentennamen über Neustarts hinweg stabil. Das Beanspruchen eines ausstehenden Konsumenten eines anderen Einträge erfordert immer noch einen expliziten Wiederherstellungsprozess. Das veröffentlichte Artefakt wurde bestanden einen isolierten echten Redis-Neustart-/Bestätigungstest und die vollständige Go-Race-Suite. Andere Backend-Adapter erfordern echte, authentifizierte Client-Implementierungen. Diese Adapter Transport-Ereignis-Envelopes; sie prägen oder verifizieren MAIP-Signaturen nicht automatisch. Die Kafka-Beleggenerierung ist ein separater Konnektor, der oben beschrieben wird.
Das eigenständige Gateway ist nicht bereit für die Bereitstellung: seine Backend-Client-Fabriken sind nicht verdrahtet, und es verweigert nun den Start, anstatt nicht durchgeführte Veröffentlichungen als akzeptiert. Es gibt keine veröffentlichte truthlocks_streaming.StreamingGateway Python-API, die dem älteren Beispiel auf dieser Seite entspricht.
Die Deduplizierung verwendet jetzt einen begrenzten exakten Cache bestätigter Ereignisidentitäten, der begrenzt ist an Mandanten und Quelle. Fehlgeschlagene Veröffentlichungen werden nicht zwischengespeichert. Wiederholungen sind standardmäßig null; explizite Wiederholungen bieten eine At-Least-Once-Zustellung, keine Exactly-Once-Garantien. Die Batch-Middleware verarbeitet jeweils ein Ereignis, sodass sie fehlgeschlagene Elemente nicht erraten kann. aus aggregierten Zählungen. Cache-Entleerung und Prozessneustart können Duplikate zulassen. Der Belegvalidator prüft Struktur und lokale Hash-Links; er ist keine Signatur Verifizierer. Behalten Sie authentifiziertes Routing, dauerhafte Aufbewahrung und kryptografische Validierung bei in Ihrem Anwendungsdesign.

MLflow, DVC und Delta Lake

Installieren Sie mlflow-maip, dvc-maip oder delta-lake-maip für die entsprechenden Metadaten Builder. Diese Pakete erzeugen lokale strukturierte Beweise; die Installation eines Pakets führt nicht dazu, jede Framework-Operation zu einem signierten gehosteten Beleg machen. Es gibt keine unterstützte truthlocks_mlflow.TruthlocksPlugin.enable API entsprechend dem älteren Beispiel. Verwenden Sie die vollständigen lokalen und gehosteten Beispiele in den Quell-READMEs: MLflow, DVC, Delta Lake. Anbieter-Metadaten und Artefakt-URIs überprüfen Artefakt-Bytes oder beweisen, dass ein externer Vorgang stattgefunden hat. Die gehostete Signaturprüfung tut dies nicht Transparenz-Log-Aufnahme herstellen, es sei denn, diese separate Prüfung ist erfolgreich.

Docker

Container-Quelldateien belegen nicht, dass ein öffentliches Image veröffentlicht wurde oder Akzeptanz bestanden. Die zuvor aufgelisteten truthlocks/*:latest Bilder und kombinierten Compose-Beispiel wurde nicht als funktionierende Bereitstellung verifiziert und ist kein unterstützter Schnellstart. Leiten Sie die Verfügbarkeit von Bildern nicht aus diesen historischen Namen ab. Verwenden Sie die veröffentlichte Paketversion und deren README für jede Integration. Beim Erstellen einen Container aus überprüfter Quelle, pinnen Sie diese Revision und Abhängigkeiten, liefern Sie Geheimnisse über Ihre Laufzeit und testen Sie die tatsächliche Anbieterverbindung. Slack zusätzlich erfordert seine echten Anwendungsanmeldeinformationen; ein Truthlocks API-Schlüssel allein ist nicht ausreichend. Das eigenständige Event-Stream-Gateway bleibt wie oben beschrieben nicht verfügbar.

Nächste Schritte

Maschinenidentität

Registrieren Sie Ihren ersten Agenten und verstehen Sie das MAIP-Protokoll.

Agentenautorisierung

Konfigurieren Sie Bereiche, Sitzungen und Tool-Zugriff für Ihre Agenten.

Downloads

Veröffentlichte CLI-, SDK- und IDE-Versionen sowie deren Installationsanweisungen finden.

Integrations-Hub

Alle Integrationen nach Kategorie durchsuchen.

Linear

Echte Anbieterauthentifizierung, SDK-Problemprüfung und ein Belegkommentar mit Rücklesung in einem explizit autorisierten QA-Problem bestanden. Dies etabliert keine gehostete Webhook- Belegerstellung oder kontinuierliche Synchronisation. Der Quell-Listener verifiziert Linear’s HMAC-Signatur und signierter Zeitstempel und beschränkt Ereignisse auf die konfigurierte Organisation und Team-IDs. Die Automatisierung von Projektmeilensteinen bleibt nicht verfügbar, anstatt geschätzte Beweise. Siehe die Lineare Einrichtung und Grenzen.