nullkey
493fc41e98
Manages WeKnora's first-class Custom Agent resources — server-side records (system prompt + model + allowed tools + KB scope) that the user authored in the web UI. Commands: - `weknora agent list` — tenant-visible agents (built-in + custom), sorted updated_at desc; `--limit`/`-L` caps the slice client-side. - `weknora agent view <id>` — full sdk.Agent including nested AgentConfig (mode / model / allowed_tools / KB scope). Human mode prints a compact KV layout + Config: block. - `weknora agent invoke <agent-id> "<text>"` — streams the agent's configured workflow against a query over SSE. Auto-creates a fresh session unless `--session` is passed. Streaming defaults to TTY + no-stream/no-json; agent-friendly buffered single-object output with `--json` (or `--no-stream`). Decoupled from the existing `chat` subtree: agents bring their own system prompt / tool surface / KB selection, so the chat / agent split matches the server-side resource boundary.
46 lines
1.9 KiB
Go
46 lines
1.9 KiB
Go
// Package agentcmd holds the `weknora agent` command tree:
|
|
// list / view / invoke. The directory is named `agent/` (matches cobra
|
|
// noun-verb convention) but the Go package is `agentcmd` to avoid
|
|
// shadowing cli/internal/agent (which owns SetAgentHelp + agent-aware
|
|
// help rendering for AI coding agents — a distinct concept from
|
|
// WeKnora's first-class custom-agent resources).
|
|
//
|
|
// Disambiguation in cli/AGENTS.md: "agent" in this subtree refers to
|
|
// WeKnora's user-defined Custom Agents (server resource: GET/POST
|
|
// /agents/...). The CLI's `agent invoke` calls /agent-chat/:session_id
|
|
// which dispatches the agent's configured workflow (system prompt,
|
|
// allowed tools, KB scope, retrieval thresholds, etc.). This is
|
|
// orthogonal to AGENTS.md / SetAgentHelp, which exists so AI coding
|
|
// agents (Claude Code, Cursor) consuming the CLI can read structured
|
|
// hints from --help.
|
|
package agentcmd
|
|
|
|
import (
|
|
"github.com/spf13/cobra"
|
|
|
|
"github.com/Tencent/WeKnora/cli/internal/cmdutil"
|
|
)
|
|
|
|
// NewCmd builds the `weknora agent` parent and registers leaves. Called
|
|
// from cli/cmd/root.go.
|
|
func NewCmd(f *cmdutil.Factory) *cobra.Command {
|
|
cmd := &cobra.Command{
|
|
Use: "agent",
|
|
Short: "Manage and invoke custom agents",
|
|
Long: `Custom Agents bundle a system prompt, model, tool allow-list, and KB
|
|
scope into an addressable resource. List visible agents, view a single
|
|
agent's configuration, or invoke an agent against a query.
|
|
|
|
Distinct from the per-CLI ` + "`AGENTS.md`" + ` reference: that file documents the
|
|
contract for AI coding agents (Claude Code / Cursor) running ` + "`weknora`" + `
|
|
on a user's behalf. This subtree manages WeKnora's first-class custom-agent
|
|
resources stored on the server.`,
|
|
Args: cobra.NoArgs,
|
|
Run: func(c *cobra.Command, _ []string) { _ = c.Help() },
|
|
}
|
|
cmd.AddCommand(NewCmdList(f))
|
|
cmd.AddCommand(NewCmdView(f))
|
|
cmd.AddCommand(NewCmdInvoke(f))
|
|
return cmd
|
|
}
|