指南
工具调用
AnyInt 通过与提供方兼容的模式支持面向工具的工作流,而不是采用单一的内部通用 schema。
AnyInt 通过与提供方兼容的模式支持面向工具的工作流,而不是采用单一的内部通用 schema。
当前记录的模式
| 模式 | 最适合 |
|---|---|
OpenAI 风格 tools OpenAI 兼容客户端中的流程 | 代理框架以及现有的基于 OpenAI 的循环 |
Gemini 原生 tools.functionDeclarations | 需要精确提供方语义的 Gemini 原生集成 |
Gemini 原生示例
curl https://api.anyint.ai/gemini/v1beta/models/gemini-2.0-flash:generateContent \
-H "Authorization: Bearer $ANYINT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{"text": "伦敦的气温是多少?"}
]
}
],
"tools": [
{
"functionDeclarations": [
{
"name": "get_current_temperature",
"description": "获取给定位置的当前温度。",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "城市名称,例如旧金山"
}
},
"required": ["location"]
}
}
]
}
]
}'实用指南
- 保持工具名称稳定且具有描述性
- 在执行前验证每个工具参数
- 以模型能够可靠消费的格式返回工具结果
- 同时记录工具请求和工具结果以便调试
如何选择一种模式
- 如果你的应用已经使用 OpenAI 代理循环,请保持在 OpenAI 兼容的一侧
- 如果你正在围绕 Gemini 原生工具构建,请直接使用 Gemini 路径
- 不要在一次调用路径中混用不同提供方家族的请求格式