Function Calling 教程：用 Go 实现大模型工具调用（Tool Use 原理 + openai-go 实战）

mkdir weather-agent && cd weather-agent
go mod init weather-agent
go get github.com/openai/openai-go/v3@v3.90.0
export OPENAI_API_KEY=你的key

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"
	"os"

	"github.com/openai/openai-go/v3"
	"github.com/openai/openai-go/v3/option"
	"github.com/openai/openai-go/v3/responses"
)

// 工具的真正实现：模型只"下指令"，干活的是这段 Go 代码
func getWeather(location string) string {
	return location + "：晴，22℃"
}

func main() {
	client := openai.NewClient(
		option.WithAPIKey(os.Getenv("OPENAI_API_KEY")),
	)
	ctx := context.Background()

	// 1. 发起请求，并用 JSON Schema 向模型"注册"可用工具
	params := responses.ResponseNewParams{
		Model: openai.ChatModelGPT5_2,
		Input: responses.ResponseNewParamsInputUnion{
			OfString: openai.String("纽约天气怎么样？适合出门吗？"),
		},
		Tools: []responses.ToolUnionParam{{
			OfFunction: &responses.FunctionToolParam{
				Name:        "get_weather",
				Description: openai.String("查询指定城市的天气"),
				Parameters: map[string]any{ // JSON Schema 描述参数
					"type": "object",
					"properties": map[string]any{
						"location": map[string]string{
							"type":        "string",
							"description": "城市名，如 New York",
						},
					},
					"required": []string{"location"},
				},
			},
		}},
	}

	// 2. 工具调用循环：模型可能要调用多轮工具才给出最终答案
	for {
		resp, err := client.Responses.New(ctx, params)
		if err != nil {
			log.Fatal(err)
		}

		called := false
		for _, item := range resp.Output {
			if item.Type != "function_call" {
				continue
			}
			called = true
			call := item.AsFunctionCall()
			fmt.Println("▶ 模型请求调用:", call.Name, call.Arguments)

			// 3. 解析参数并执行本地函数（参数必须校验！）
			var result string
			switch call.Name {
			case "get_weather":
				var args struct {
					Location string `json:"location"`
				}
				if err := json.Unmarshal([]byte(call.Arguments), &args); err != nil || args.Location == "" {
					result = `{"error": "invalid arguments"}`
				} else {
					result = getWeather(args.Location)
				}
			default:
				result = `{"error": "unknown tool"}`
			}

			// 4. 通过 PreviousResponseID 续接对话，回传执行结果
			params = responses.ResponseNewParams{
				Model:              openai.ChatModelGPT5_2,
				PreviousResponseID: openai.String(resp.ID),
				Input: responses.ResponseNewParamsInputUnion{
					OfInputItemList: []responses.ResponseInputItemUnionParam{{
						OfFunctionCallOutput: &responses.ResponseInputItemFunctionCallOutputParam{
							CallID: call.CallID, // 必须与模型发的 call id 对应
							Output: responses.ResponseInputItemFunctionCallOutputOutputUnionParam{
								OfString: openai.String(result),
							},
						},
					}},
				},
			}
		}

		// 5. 输出里没有 function_call 了，就是最终自然语言回答
		if !called {
			fmt.Println("✔ 最终回答:", resp.OutputText())
			break
		}
	}
}

▶ 模型请求调用: get_weather {"location": "New York"}
✔ 最终回答: 纽约今天晴，22℃，天气舒适，适合出门。