DocsAI 连接 / Gemini

Gemini

Gemini 目前尚未提供 Anthropic 风格的原生 MCP 连接器,因此最稳定的方式是在 Gemini API 或 Google AI Studio 中通过 Function Calling 将 FindIP REST API 注册为工具。

前置条件

Gemini API Key(由 Google AI Studio 签发)以及 FindIP API Key。

配置步骤

1

申请 FindIP API Key

在控制台创建密钥,并保存为环境变量。

bash
export FINDIP_API_KEY="psk_live_..."
2

编写 Function Declaration

在 Gemini SDK 中将 FindIP 检索声明为工具。

python
from google import genai
from google.genai import types

client = genai.Client()

findip_search = types.FunctionDeclaration(
  name="findip_search",
  description="对中、美、日、韩、EP 五国专利进行语义检索。",
  parameters={
      "type": "object",
      "properties": {
          "query": {"type": "string"},
          "top_k": {"type": "integer", "default": 10},
      },
      "required": ["query"],
  },
)

tools = types.Tool(function_declarations=[findip_search])
3

工具调用处理函数

当模型请求函数调用时,实际调用 FindIP REST API。

python
import os, requests

def handle_findip_search(args):
  res = requests.post(
      "https://api.findip.ai/api/v1/search/semantic",
      headers={"X-API-Key": os.environ["FINDIP_API_KEY"]},
      json=args,
      timeout=30,
  )
  return res.json()
4

运行对话

向 Gemini 模型发送自然语言查询 → 模型发起工具调用 → 将结果返回给模型 → 获得最终答复。

示例提示词

Prompt

"请整理近 3 年中国在固体氧化物燃料电池(SOFC)领域的申请趋势及前 5 位申请人。"

常见问题

是否可以在 Gemini Extensions 中注册 FindIP?

Extensions 仅可注册由 Google 精选的条目。自定义集成请使用 Function Calling 或 Agent Builder。

在 Vertex AI 上是否同样可用?

可以。在 Vertex AI Gemini 的 Tool 功能中注册同样的 declaration 即可。代码上仅需将 SDK 切换为 vertexai 包。

AI 连接Next: 检索指南
FindIP | Semantic Patent Search