Feature request: GoldenDirectiveTool (harmonic relationship score, full vs cropped reporting)

Aperta Adatta ai principianti
  • Qualcosa non va?
#9,200 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
66/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
python
Ambito
ai, tooling

Direzione di ricerca

Inizia leggendo gli strumenti esistenti in lib/crewai-tools per scoprire come gli strumenti autonomi definiscono gli input e riportano i risultati. Implementa il calcolo di Golden Directive per A con segno ed E non negativo a fotogramma intero, e includi Y ritagliato e il divario tra fotogramma intero e ritagliato quando viene fornito E ritagliato. Il lavoro è completato quando lo strumento riporta i punteggi richiesti senza misurare A o E; l’issue non indica alcun file di test, quindi individua i test degli strumenti più vicini ed eseguili.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

feature-request
Feature Area

Core functionality

Is your feature request related to a an existing bug? Please link it here.

NA

Describe the solution you'd like

Feature request

Add a GoldenDirectiveTool to crewai_tools (lib/crewai-tools): a self-contained tool, no external dependencies, that calculates the Golden Directive relationship score:

Y = 2(A x E) / (A + E)

Inputs are an agent score A, an environment health score E (full frame), and optionally a cropped-frame E. Output reports full Y, and when a cropped E is given, cropped Y and the full-versus-cropped gap, as the Directive's reporting rule requires.

The Golden Directive (https://thegoldendirective.pages.dev/) is a candidate training reward proposed by Paul Eisman. A is the agent's actions tally — verified gives minus takes, in counts; it is signed and can go negative, there is no floor under it. E is the level of everything not-A in the frame, against a healthy baseline; a level cannot go below 0. If either A or E reaches 0, Y reaches 0.

Scope, stated plainly:

  • This tool performs the calculation and reporting only. It does not measure A or E; in the source proposal, A and E measurement is not yet operational for real training.
  • The Directive itself is a proposal, not a deployed solution. Its results so far are pilot-scale toy gridworld runs, reported on the site.

Why

CrewAI agents currently have no built-in way to score an action against the health of the environment it acts on. This tool gives crews a one-number relationship check — act so that both sides stay strong — with the full-frame versus cropped-frame gap reported, so a score that only looks good inside a narrow frame is visible as such.

A pull request implementing this was previously submitted as #8929 and auto-closed for want of this issue; it will be reopened referencing this issue once the issue is open.

Describe alternatives you've considered

No response

Additional context

No response

Willingness to Contribute

Yes, I'd be happy to submit a pull request

Lingua principale
Python
Stelle
60.4k
Fork
9k
Merge medio
1g 4h
PR unite (30g)
210

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di crewAIInc/crewAI

Tutte le issue di crewAIInc/crewAI

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.