Pular para o conteúdo principal

Visão geral

As impressões digitais na CrewAI fornecem uma maneira de identificar e rastrear componentes de forma única durante todo o seu ciclo de vida. Cada Agent, Crew e Task recebe automaticamente uma impressão digital única quando criado, que não pode ser sobrescrita manualmente. Essas impressões digitais podem ser usadas para:
  • Auditoria e rastreamento do uso de componentes
  • Garantir a integridade da identidade dos componentes
  • Anexar metadados aos componentes
  • Criar uma cadeia rastreável de operações

Como funciona a impressão digital

Uma impressão digital é uma instância da classe Fingerprint do módulo crewai.security. Cada impressão digital contém:
  • Uma string UUID: Um identificador único para o componente, gerado automaticamente e que não pode ser definido manualmente
  • Um timestamp de criação: Quando a impressão digital foi gerada, definido automaticamente e que não pode ser modificado manualmente
  • Metadados: Um dicionário de informações adicionais que pode ser customizado
As impressões digitais são geradas e atribuídas automaticamente quando um componente é criado. Cada componente expõe sua impressão digital por meio de uma propriedade de somente leitura.

Uso básico

Acessando impressões digitais

Trabalhando com metadados das impressões digitais

Você pode adicionar metadados às impressões digitais para fornecer contexto adicional:

Persistência das impressões digitais

As impressões digitais foram projetadas para persistir e permanecer inalteradas durante todo o ciclo de vida de um componente. Se você modificar um componente, a impressão digital permanece a mesma:

Impressões digitais determinísticas

Apesar de não ser possível definir diretamente o UUID e o timestamp de criação, é possível criar impressões digitais determinísticas usando o método generate com uma seed:

Uso avançado

Estrutura da impressão digital

Cada impressão digital possui a seguinte estrutura: