Integrações MAIP
O Machine Agent Identity Protocol (MAIP) vem com integrações que trazem identidade de agente, recibos e pontuação de confiança para seus fluxos de trabalho existentes. Evidências locais, envio de recibos hospedados e verificação de assinatura são operações separadas. Configure e teste a integração que você usa; a instalação por si só não cria um registro de auditoria completo.Pré-requisitos: Você precisa de uma conta Truthlocks com uma chave de API e pelo menos um agente registrado. Consulte o guia de identidade de máquina para registrar seu primeiro agente.
Ferramentas do desenvolvedor
Extensão VS Code
Um painel lateral para navegar por recibos, gerar recibos do seu editor e visualizar dados de confiança. Instale-o no Visual Studio Marketplace. O que ele faz:- Navegar e pesquisar recibos MAIP na barra lateral
- Gerar recibos para alterações de código diretamente do editor
- Visualizar pontuações de confiança do agente e cadeias de recibos
- Abra o VS Code e vá para a visualização de Extensões (
Ctrl+Shift+X/Cmd+Shift+X). - Procure por “Truthlocks MAIP”.
- Clique em Instalar.
Plugin JetBrains
Integração MAIP para IntelliJ, PyCharm e WebStorm com os mesmos recursos de navegação e geração de recibos da extensão do VS Code.Plugin Neovim
Instale o plugintruthlocks/maip.nvim lançado, com curl disponível no seu PATH:
:MAIPListAgents, :MAIPCreateReceipt, :MAIPListReceipts,
:MAIPVerifyReceipt, :MAIPShowTrust e :MAIPDashboard. Os metadados do recibo são
não é uma assinatura verificada. Os recibos de commit automáticos são opcionais e observam os suportados
eventos de commit concluídos; não há opção auto_receipt de salvamento nesta versão.
Consulte o README versionado para Telescope
configuração e os limites atuais de teste interativo.
Servidor MCP
Instale o executável na máquina que executa o seu host MCP:maip_list_agents, maip_list_receipts e maip_verify_receipt. Uma assinatura positiva
o resultado requer valid: true, signature_verified: true e verdict: "VALID".
A verificação de transparência é um resultado separado. As gravações não são automaticamente repetidas.
Colaboração em equipe
As integrações Slack, Linear e Notion exigem seus próprios aplicativos/espaços de trabalho reais credenciais além da autenticação Truthlocks. Sua cadeia completa de provedor-para-recibo a aceitação ainda está pendente. Não trate a disponibilidade da fonte, testes locais ou um Chave de API do Truthlocks como prova de que um espaço de trabalho externo está conectado. Revise o README do pacote de origem para permissões e configuração do provedor: Slack, Linear, Notion. Use um espaço de trabalho de teste dedicado antes de habilitar o processamento de eventos reais.Configuração e validação do Slack
Slack é uma instalação de origem, não um pacote npm@truthlocks/maip-slack publicado.
Sua autenticação de bot e uma submissão de mensagem de teste autorizada passaram pelo provedor
verificações. Os fluxos de trabalho completos de comando de barra de usuário pessoal e eventos hospedados permanecem em desenvolvimento
validação. Siga o README do Slack
para a compilação revisada e todas as configurações necessárias.
Vincule o aplicativo a SLACK_TEAM_ID e SLACK_ALLOWED_USER_IDS pessoais explícitos.
Use MAIP_AGENT_ID de um agente Truthlocks registrado existente para criação;
um ID de Membro do Slack não é uma identidade de máquina. Forneça uma chave de sandbox e
https://sandbox-api.truthlocks.com/v1 durante a avaliação. Comandos são registrados
nas configurações do aplicativo do Slack. Tanto o modo HTTP quanto o Socket fornecem /webhook/maip, mas
hospedar o listener não assina automaticamente os eventos do Truthlocks a ele.
As aprovações de delegação permanecem em revisão no Console autenticado. Proteção de repetição local
é local ao processo; a entrega em produção precisa de rastreamento upstream durável.
Configuração e validação do Notion
Notion é um pacote de origem privada, não uma instalação npm. Aceitação de QA real criou uma página filha e esquemas de banco de dados, inseriu um recibo de espaço de trabalho existente, repetiu a sincronização sem duplicar essa página e verificou a leitura do provedor. A automação contínua hospedada e a recuperação durável permanecem em validação. Conecte apenas a página pretendida usando o menu ••• → Conexões do Notion. Siga o README do Notion para inicializar bancos de dados uma vez e reutilizar seus IDs. UseWEBHOOK_SECRET com o
contrato HMAC/timestamp versionado; solicitações não assinadas são rejeitadas. Status do recibo
é metadados, então um recibo concluído não verifica automaticamente o Notion
caixa Verificado. Use a verificação explícita de assinatura separadamente.
CI/CD
As entradas da ação MAIP sãomaip-api-url, maip-api-key e maip-agent-id.
Os nomes mais antigos api-key e agent-id não são entradas declaradas. Para um revisado
checkout da fonte com seu dist/index.js construído, um fluxo de trabalho de QA explicitamente acionado
pode usar esta etapa:
Conectores de modelo de IA
Os wrappers Python capturam eventos emitidos através da integração configurada. Hashes locais não são assinaturas de servidor. As credenciais do provedor, as credenciais do Truthlocks e o envio hospedado são configurados separadamente; inspecione os metadados que você envia e não presuma que o hashing remove as obrigações de privacidade.Frameworks suportados
Exemplo completo de LangChain local (sem solicitação hospedada):
payload_hash descreve evidências locais. Para envio hospedado, use MAIPClient.create_receipt
e verifique o receipt_id do servidor retornado; o README do LangChain
contém o exemplo de submissão assíncrona. Para hooks automáticos assíncronos, descarregue e
fechar o wrapper e inspecionar os resultados da submissão antes do desligamento. Chamadas fora do
wrapper configurado não são observadas.
Pipelines de dados e ML
Conector Kafka
O conector Go envia impressões digitais de mensagens como recibos MAIPdata.attestation
usando um agente existente. Seu cliente HTTP usa /v1/agent-receipts, preserva parcial
resultados de lote e requer uma assinatura confirmada para verificação bem-sucedida.
Instale github.com/truthlocks/kafka-maip-connector@v0.1.0 com go get.
Consulte o exemplo de lançamento e conclusão.
A chave de API seleciona o espaço de trabalho e o ambiente; um ID de locatário fornecido pelo chamador não
não substitui a autorização. Bytes de mensagem e chaves de mensagem brutas não são carregados.
Os wrappers produtor/consumidor armazenam recibos em buffer na memória. Entrega e recebimento do broker
entrega são operações separadas; uma gravação bem-sucedida no Kafka não garante uma
recibo foi retido. A entrega de auditoria necessária precisa de uma caixa de saída de aplicativo durável
e tratamento explícito de falhas. Consulte a evidência de lançamento antes do uso em produção.
Streaming de eventos
Instale Go event-stream v0.1.0:MLflow, DVC e Delta Lake
Instalemlflow-maip, dvc-maip ou delta-lake-maip para os metadados correspondentes
construtores. Esses pacotes produzem evidências estruturadas locais; a instalação de um não
tornar cada operação de framework um recibo hospedado assinado. Não há suporte
truthlocks_mlflow.TruthlocksPlugin.enable API correspondente ao exemplo mais antigo.
Use os exemplos locais e hospedados completos nos READMEs de origem:
MLflow,
DVC,
Delta Lake.
Os metadados do provedor e os URIs de artefato não verificam independentemente os bytes do artefato ou
provar que uma operação externa ocorreu. A verificação de assinatura hospedada não
estabelecer a inclusão no log de transparência, a menos que essa verificação separada seja bem-sucedida.
Docker
Os arquivos de origem do contêiner não estabelecem que uma imagem pública foi lançada ou passou na aceitação. As imagenstruthlocks/*:latest listadas anteriormente e combinadas
O exemplo de composição não foi verificado como uma implantação funcional e não é um
início rápido suportado. Não infira a disponibilidade da imagem a partir desses nomes históricos.
Use o lançamento do pacote publicado e seu README para cada integração. Se estiver construindo
um contêiner de fonte revisada, fixe essa revisão e dependências, forneça segredos
através do seu tempo de execução e teste a conexão real do provedor. O Slack adicionalmente
requer suas credenciais de aplicativo reais; uma chave de API Truthlocks sozinha é insuficiente.
O gateway de fluxo de eventos autônomo permanece indisponível conforme descrito acima.
Próximos passos
Identidade da máquina
Registre seu primeiro agente e entenda o protocolo MAIP.
Autorização do agente
Configure escopos, sessões e acesso a ferramentas para seus agentes.
Downloads
Encontre as versões publicadas de CLI, SDK e IDE e suas instruções de instalação.
Central de integrações
Navegue por todas as integrações por categoria.

