Tool - Commandline
CommandLine Tool
CommandLine Tools implementation for Eino that implements the Tool
interface. This enables seamless integration with Eino’s LLM capabilities for enhanced natural language processing and generation.
Note: This implementation is inspired by and references the OpenManus project.
Features
- Implements
github.com/cloudwego/eino/components/tool.InvokableTool
- Easy integration with Eino’s tool system
- Support executing command-line instructions in Docker containers
Installation
go get github.com/cloudwego/eino-ext/components/tool/commandline@latest
Quick Start
Here’s a quick example of how to use the commandline tool:
Editor:
package main
import (
"context"
"log"
"github.com/cloudwego/eino-ext/components/tool/commandline"
"github.com/cloudwego/eino-ext/components/tool/commandline/sandbox"
)
func main() {
ctx := context.Background()
op, err := sandbox.NewDockerSandbox(ctx, &sandbox.Config{})
if err != nil {
log.Fatal(err)
}
// you should ensure that docker has been started before create a docker container
err = op.Create(ctx)
if err != nil {
log.Fatal(err)
}
defer op.Cleanup(ctx)
sre, err := commandline.NewStrReplaceEditor(ctx, &commandline.Config{Operator: op})
if err != nil {
log.Fatal(err)
}
info, err := sre.Info(ctx)
if err != nil {
log.Fatal(err)
}
log.Printf("tool name: %s, tool desc: %s", info.Name, info.Desc)
content := "hello world"
log.Println("create file[test.txt]...")
result, err := sre.Execute(ctx, &commandline.StrReplaceEditorParams{
Command: commandline.CreateCommand,
Path: "./test.txt",
FileText: &content,
})
if err != nil {
log.Fatal(err)
}
log.Println("create file result: ", result)
log.Println("view file[test.txt]...")
result, err = sre.Execute(ctx, &commandline.StrReplaceEditorParams{
Command: commandline.ViewCommand,
Path: "./test.txt",
})
if err != nil {
log.Fatal(err)
}
log.Println("view file result: ", result)
}
PyExecutor:
/*
* Copyright 2025 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 main
import (
"context"
"log"
"github.com/cloudwego/eino-ext/components/tool/commandline"
"github.com/cloudwego/eino-ext/components/tool/commandline/sandbox"
)
func main() {
ctx := context.Background()
op, err := sandbox.NewDockerSandbox(ctx, &sandbox.Config{})
if err != nil {
log.Fatal(err)
}
// you should ensure that docker has been started before create a docker container
err = op.Create(ctx)
if err != nil {
log.Fatal(err)
}
defer op.Cleanup(ctx)
exec, err := commandline.NewPyExecutor(ctx, &commandline.PyExecutorConfig{Operator: op}) // use python3 by default
if err != nil {
log.Fatal(err)
}
info, err := exec.Info(ctx)
if err != nil {
log.Fatal(err)
}
log.Printf("tool name: %s, tool desc: %s", info.Name, info.Desc)
code := "print(\"hello world\")"
log.Printf("execute code:\n%s", code)
result, err := exec.Execute(ctx, &commandline.Input{Code: code})
if err != nil {
log.Fatal(err)
}
log.Println("result:\n", result)
}
For More Details
最后修改
April 28, 2025
: docs: update eino ext docs (#1314) (b49af87)