agents: support the full run lifecycle and drop the classic agents fallback

Aperta
  • Qualcosa non va?
#169 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
52/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
go
Ambito
api, cli

Direzione di ricerca

Start by reading the existing agents run command and its API client calls, then check api-client-go v0.17.3 for the platform Agents methods named in the issue. Trace where the classic agents endpoints are called so those fallbacks can be removed. Done means the CLI can start, poll, answer and cancel durable runs, and no agents subcommand calls a /rest/api/v1/agents/* endpoint.

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

Descrizione

enhancement

glean agents is platform-first, but agents run only creates a request-bound run and waits. The platform Agents API (GA) also supports the rest of the run lifecycle, and api-client-go v0.17.3 models it:

  • GET /api/agents/{agent_id}/runs/{run_id}: Glean.Agents.GetRun
  • POST /api/agents/{agent_id}/cancellations: Glean.Agents.CancelRun
  • POST /api/agents/{agent_id}/responses: Glean.Agents.RespondToRun (approval requests)
  • execution_mode: DURABLE on POST /api/agents/{agent_id}/runs: starts a persisted run and returns immediately

The CLI also still falls back to the classic agents endpoints (Client.Agents.List, Retrieve, RetrieveSchemas, Run). Those endpoints are deprecated, with removal scheduled for 2027-04-15.

Proposal

  • Add agents runs get, agents runs cancel and agents runs respond (exact names to be decided).
  • Let agents run start a durable run and print the run ID, for example with --durable.
  • Remove the classic agents fallback before 2027-04-15.

Done when

  • A durable run can be started, polled, answered and cancelled from the CLI.
  • No agents subcommand calls a /rest/api/v1/agents/* endpoint.
Lingua principale
Go
Stelle
65
Fork
8
Merge medio
5g 7h
PR unite (30g)
3

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 gleanwork/glean-cli

Tutte le issue di gleanwork/glean-cli

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.