agentsdk

README

Agent SDK

A minimized agent sdk that supports mcp and skills calls.

使用方式

    rcfg := &agentsdk.Config{
        SkillsDir:  os.Getenv("SKILL_DIRS"), // 指定 skills 文件夹，由于最小化，并不通用。尽可能符合 openai skill 调用方式
        MCPServers: nil,
        APIKey:     os.Getenv("OPENAI_API_KEY"),
        APIBase:    os.Getenv("OPENAI_API_BASE"),
        Model:      os.Getenv("OPENAI_API_MODE"),
        Debug:      true,
    }

    agent, e := agentsdk.New(rcfg)
    if e != nil {
        panic(e)
    }

    resp, e := agent.Run(context.Background(), os.Getenv("INPUT"))
    if e != nil {
        panic(e)
    }
    fmt.Println(resp)

参考项目

1. goskills
2. anna

Documentation

Index

• func GetContextID(ctx context.Context) (id string)
• func SetContextID(ctx context.Context, id string) context.Context
• type Agent
  • func New(cfg *Config) (a *Agent, e error)
  • func (a *Agent) Chat(ctx context.Context, prompt string) (content string, e error)
  • func (a *Agent) Messages() (lst []openai.ChatCompletionMessage)
  • func (a *Agent) NewChat(history []openai.ChatCompletionMessage) (n *Agent)
  • func (a *Agent) Run(ctx context.Context, userPrompt string) (resp string, e error)
• type Config
• type OpenAIChatClient

Functions

func GetContextID

func GetContextID(ctx context.Context) (id string)

func SetContextID

func SetContextID(ctx context.Context, id string) context.Context

Types

type Agent

type Agent struct {
	// contains filtered or unexported fields
}

Agent manages the skill discovery, selection, and execution process.

func New

func New(cfg *Config) (a *Agent, e error)

New creates and initializes a new Agent.

func (*Agent) Chat

func (a *Agent) Chat(ctx context.Context, prompt string) (content string, e error)

Chat reuse all configurations, just reset context message

func (*Agent) Messages

func (a *Agent) Messages() (lst []openai.ChatCompletionMessage)

Messages reuse all configurations, just reset context message

func (*Agent) NewChat

func (a *Agent) NewChat(history []openai.ChatCompletionMessage) (n *Agent)

NewChat reuse all configurations, just reset context message

func (*Agent) Run

func (a *Agent) Run(ctx context.Context, userPrompt string) (resp string, e error)

Run executes the main skill selection and execution logic for a single turn.

type Config

type Config struct {
	APIKey        string
	APIBase       string
	Model         string
	SkillsDir     string
	MCPServers    map[string]mcp.MCPServer
	MCPMaxRetries int
	Debug         bool
	History       []openai.ChatCompletionMessage
}

Config holds all the necessary configuration for the runner.

type OpenAIChatClient

type OpenAIChatClient interface {
	CreateChatCompletion(ctx context.Context, req openai.ChatCompletionRequest) (openai.ChatCompletionResponse, error)
}

OpenAIChatClient interface for dependency injection and testing