DocsAI 接続 / Gemini

Gemini

Gemini は現時点で Anthropic スタイルのネイティブ MCP コネクタを提供していないため、Gemini API または Google AI Studio で Function Calling により FindIP REST API をツールとして登録する方法が最も安定しています。

事前準備

Gemini API キー(Google AI Studio で発行)と FindIP API キー。

設定手順

1

FindIP API キーの発行

ダッシュボードでキーを作成し、環境変数として保存します。

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 の 5 か国特許をセマンティック検索します。",
  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

"固体酸化物形燃料電池(SOFC)分野について、直近 3 年の日本の出願動向と上位出願人 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