第 27 章建议:补一个 MCP 写操作超时后确认结果的最小案例

Aperta Adatta ai principianti
#35 0 commenti 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
Mezza giornata
Idoneità per principianti
62/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva

Direzione di ricerca

Leggi content/chapters/chapter-27.md, in particolare il paragrafo sulle chiavi di idempotenza e sui controlli di stato, e verifica se il capitolo ha già una voce di esempio da riutilizzare. L’esempio è un endpoint locale mock di ticket, indicizzato da un operation ID stabile, che copre tre percorsi: scrittura normale più rilettura, una risposta persa seguita da una query di stato e un retry sulla stessa chiave, e una query di stato non disponibile che lascia il ticket in sospeso per la gestione manuale. Fatto quando la demo mostra un ticket, il suo stato finale e log correlati per operation ID; conferma la posizione con i maintainer prima di scrivere.

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

Descrizione

第 27 章「MCP 权限管理」已经提到用幂等键、唯一约束和状态检查避免重复写入。我建议在这一段后面加一个小例子,让读者看到「调用超时」和「业务写入失败」是两种不同的状态。

可以用一个本地模拟工单接口。调用前生成稳定的业务操作 ID,服务端写入后可按 ID 查询结果。同一请求演示三种路径:

  1. 正常返回,回读确认工单存在。
  2. 服务端写入后故意丢掉响应。客户端超时后先查状态;需要重试时复用同一个幂等键,最终仍只有一张工单。
  3. 状态查询也不可用。保持「待确认」,把异常交回人工处理。

用工单数量、最终状态和按操作 ID 关联的日志验收这个示例即可。这个用例来自我在整理 Agent-Ready Engineering 的操作契约时想验证的一项行为。

想请教维护者,这样的补充适合放在本章末尾,还是做成单独的共建案例?如果第 27 章已有适合复用的示例入口,我很乐意先把范围对齐。

Lingua principale
HTML
Stelle
520
Fork
87
Merge medio
20m
PR unite (30g)
18

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 modelscope/ms-cookbook

Tutte le issue di modelscope/ms-cookbook

Issue simili

Altre issue su Content

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.