ai_old/README.md
2024-09-17 18:44:21 +08:00

205 lines
2.6 KiB
Markdown

# 低代码AI能力工具包
## 命令行工具
### Install
```shell
go install apigo.cc/ai/ai/ai@latest
```
### Usage
```shell
ai -h | --help show usage
ai -e | --export export ai.ts file to ./lib for develop
ai test | test.js run test.js, if not specified, run ./ai.js
```
### Sample
#### test.js
```javascript
import {glm} from './lib/ai'
import console from './lib/console'
function main(...args) {
if(!args[0]) throw new Error('no ask')
let r = glm.fastAsk(args[0], r => {
console.print(r)
})
console.println()
return r
}
```
#### run sample
```shell
ai test "你好"
```
### Module
#### mod/glm.js
```javascript
import {glm} from './lib/ai'
import console from './lib/console'
function chat(...args) {
if(!args[0]) throw new Error('no prompt')
return glm.fastAsk(args[0])
}
function draw(...args) {
if(!args[0]) throw new Error('no ask')
return glm.makeImage(args[0], {size:'1024x1024'})
}
module.exports = {chat, draw}
```
#### test.js
```javascript
import glm from './mod/glm'
function main(...args) {
console.println(glm.chat(args[0]))
}
```
#### run sample
```shell
ai test "你好"
```
### Configure
#### llm.yml
```yaml
openai:
apiKey: ...
zhipu:
apiKey: ...
```
#### or use env.yml
#### llm.yml
```yaml
llm:
openai:
apiKey: ...
zhipu:
apiKey: ...
```
#### encrypt apiKey
install sskey
```shell
go install github.com/ssgo/tool/sskey@latest
sskey -e 'your apiKey'
```
copy url base64 format encrypted apiKey into llm.yml or env.yml
#### config with special endpoint
```yaml
llm:
openai:
apiKey: ...
endpoint: https://api.openai.com/v1
```
#### config multi api
```yaml
llm:
glm:
apiKey: ...
llm: zhipu
glm2:
apiKey: ...
endpoint: https://......
llm: zhipu
```
## 调用 JavaScript API
### Install
```shell
go get apigo.cc/ai/ai
```
### Usage
```go
package main
import (
"apigo.cc/ai/ai/js"
"fmt"
)
func main() {
result, err := js.Run(`return ai.glm.fastAsk(args[0])`, "", "你好")
// js.RunFile
// js.StartFromFile
// js.StartFromCode
if err != nil {
fmt.Println(err.Error())
} else if result != nil {
fmt.Println(result)
}
}
```
## 调用 Go API
### Install
```shell
go get apigo.cc/ai/ai
```
### Usage
```go
package main
import (
"apigo.cc/ai/ai"
"apigo.cc/ai/ai/llm"
"fmt"
)
func main() {
ai.Init()
glm := llm.Get("zhipu")
r, usage, err := glm.FastAsk(llm.Messages().User().Text("你是什么模型").Make(), func(text string) {
fmt.Print(text)
})
if err != nil {
fmt.Println(err)
} else {
fmt.Println()
fmt.Println("result:", r)
fmt.Println("usage:", usage)
}
}
```