72 lines
2.2 KiB
Go
72 lines
2.2 KiB
Go
/*
|
|
* Copyright 2024 CloudWeGo Authors
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
// Package agent defines common option types used by agents and multi-agents.
|
|
package agent
|
|
|
|
import "github.com/cloudwego/eino/compose"
|
|
|
|
// AgentOption is the common option type for various agent and multi-agent implementations.
|
|
// For options intended to use with underlying graph or components, use WithComposeOptions to specify.
|
|
// For options intended to use with particular agent/multi-agent implementations, use WrapImplSpecificOptFn to specify.
|
|
type AgentOption struct {
|
|
implSpecificOptFn any
|
|
composeOptions []compose.Option
|
|
}
|
|
|
|
// GetComposeOptions returns all compose options from the given agent options.
|
|
func GetComposeOptions(opts ...AgentOption) []compose.Option {
|
|
var result []compose.Option
|
|
for _, opt := range opts {
|
|
result = append(result, opt.composeOptions...)
|
|
}
|
|
|
|
return result
|
|
}
|
|
|
|
// WithComposeOptions returns an agent option that specifies compose options.
|
|
func WithComposeOptions(opts ...compose.Option) AgentOption {
|
|
return AgentOption{
|
|
composeOptions: opts,
|
|
}
|
|
}
|
|
|
|
// WrapImplSpecificOptFn returns an agent option that specifies a function to modify the implementation-specific options.
|
|
func WrapImplSpecificOptFn[T any](optFn func(*T)) AgentOption {
|
|
return AgentOption{
|
|
implSpecificOptFn: optFn,
|
|
}
|
|
}
|
|
|
|
// GetImplSpecificOptions returns the implementation-specific options from the given agent options.
|
|
func GetImplSpecificOptions[T any](base *T, opts ...AgentOption) *T {
|
|
if base == nil {
|
|
base = new(T)
|
|
}
|
|
|
|
for i := range opts {
|
|
opt := opts[i]
|
|
if opt.implSpecificOptFn != nil {
|
|
optFn, ok := opt.implSpecificOptFn.(func(*T))
|
|
if ok {
|
|
optFn(base)
|
|
}
|
|
}
|
|
}
|
|
|
|
return base
|
|
}
|