目次:詰まり · 対照 · ホワイトリスト · ルーティング · 再試行 · マスキング · PR/CI · 手順 · 予算 · FAQ
CrewAI 稿・Semantic Kernel 稿と役割を分け、本稿はAutoGen の GroupChatです。Schema 再試行・LiteLLM・可観測性と併読ください。
運用で詰まる三つ
一ベース URL と鍵がエージェントごとに分岐し監査が途切れる。二並行が積み上がり遮断や 503 を誘発する。三スタックやプロンプト全文を返しレビューと保管に失敗する。
編排スタックの対照
| 観点 | AutoGen | Crew/Kernel |
|---|---|---|
| 単位 | GroupChat とツール | Crew・Task/プラグイン |
| 並行 | 発話とツール扇出 | 複数 Crew・束ね |
| 締め | 会話 ID と Schema | タスク名・別名 |
最小権限のツールホワイトリスト
Dashboard でゲートウェイトークンの許可をモデル別名とツール HTTP のホスト・接頭辞・メソッドに限定します。関数ごとにJSON Schemaで上限と列挙を固定し逸脱はゲートウェイで弾きます。上流鍵は OpenClaw 側のみ、アプリは短寿命 Bearer のみです。
会話ルーティング
選言ルールとモデルを分けプランナと実行者に別モデル別名を割当て、X-Request-ID とセッション ID でログを突合します。LangGraph 稿のグラフ単位とは役割が異なり、ここでは発話順が主です。
再試行テンプレート
読み取りは指数バックオフ最大三回、書き込みはべき等キー時のみ一回、サーキット開放中は即失敗。要約 JSON の retryable に可否を載せ、自然言語は一行に抑えます。
export OPENAI_API_KEY="$OC_GATEWAY_TOKEN"
export OPENAI_BASE_URL="https://<gw>/v1"
export AUTOGEN_TOOL_CONCURRENCY=3ログのマスキング
ログは種別・HTTP・経過秒・短縮ハッシュまで。Bearer やメールはマスクし、プロンプト全文は暗号化ストレージへ分離します。
PR/CI サマリ例
PR 本文や CI 失敗欄に autogen/oc | circuit_open | retryable=false | p95=4.2s | req=sha256:abcd…ef の一行を貼り、遮断と Schema 逸脱を分類します。スタックは成果物 URL のみです。
再現手順(六段)
- Python・pyautogen・openai をロックし launchd で OpenClaw 常駐
- Dashboard で短寿命 Bearer、ファイル 0600
- AutoGen の base_url をゲートウェイ OpenAI 互換へ
- ツールに Schema を添付し出口をホワイトリスト照合
- ゲートウェイの並行・RPM・サーキットに asyncio セマフォを合わせる
- 遮断と 401 を模擬し要約とマスキングだけ残るか確認
並行予算とサーキットの目安
| 軸 | ゲートウェイ | AutoGen 側 |
|---|---|---|
| 並行 | テナント in-flight | ツール同時上限 |
| レート | RPM・TPM | ラウンド間隔 |
| サーキット | エラー率窓 | 開放中は再試行停止 |
FAQ
Crew 稿と併用。 テナントとトークンを分け並行プールは共有しない。
Kernel 名と衝突。 別名と path 接頭辞で名前空間分離。
要約:OpenClaw で認可と Schema と並行予算を先に固定し、マスキングと短い要約で監査と PR をつなぎます。