types

type ContextVars ¶

type ContextVars map[string]any

ContextVars represents a key-value store of context variables used for template rendering. It maps string keys to values of any type. These variables can be used to customize agent instructions through template substitution.

Common use cases include:

• Passing user information to agents
• Configuring agent behavior dynamically
• Sharing state between conversation turns
• Providing environment-specific settings

Example usage:

vars := ContextVars{
    "user_id": "123",
    "preferences": map[string]string{
        "language": "en",
        "timezone": "UTC",
    },
    "features": []string{"chat", "search"},
    "settings": struct {
        Theme    string `json:"theme"`
        FontSize int    `json:"fontSize"`
    }{
        Theme:    "dark",
        FontSize: 14,
    },
}

The variables can be used in agent instructions:

agent := agent.New(
    agent.Instructions(`
        User ID: {{.user_id}}
        Language: {{.preferences.language}}
        Features: {{range .features}}{{.}} {{end}}
    `),
)

Thread Safety: ContextVars is a map type and is not safe for concurrent modification. If variables need to be modified during execution, proper synchronization should be implemented by the caller.

func (cv ContextVars) String() string

vars := ContextVars{"key": "value"}
fmt.Println(vars.String()) // Output: {"key":"value"}