get-contact

連絡先を検索

名前で検索して、連絡先情報（メールアドレス、電話番号）を見つけます。

ソース

連絡先のソースを設定します。例：

• ローカル JSON - ~/contacts.json または CRM のデータファイル
• Google Contacts - People API 経由（将来対応予定）
• 任意の CRM - お使いのシステムに合わせて検索方法を調整します

使用方法

連絡先情報が必要な場合：

1. 名前で連絡先を検索します（一部一致、大文字と小文字を区別しない）
2. 結果が0件 → ユーザーに「見つかりませんでした。メールアドレスまたは電話番号を入力してください」と伝えます
3. 結果が1件 → ユーザーに「[名前] - [メールアドレス]が見つかりました。こちらでよろしいですか？」と確認します
4. 結果が複数件 → ユーザーに「複数見つかりました：1）名前A 2）名前B」のように選択を求めます

重要

連絡先情報を使用する前に、必ずユーザーに確認してください。 一般的な名前（יוסי、דוד、John、David）には複数の人物が該当する場合や、ユーザーが連絡先に登録されていない人を指している場合があります。

検索例（JSON）

# Search by name in contacts file
jq '.contacts[] | select(.name | test("QUERY"; "i")) | {name, email, phone}' ~/contacts.json

応答形式

呼び出し元のスキルに返します：

{
  "found": true,
  "count": 1,
  "contact": {
    "name": "John Smith",
    "email": "[email protected]",
    "phone": "+1234567890"
  }
}

複数件ある場合：

{
  "found": true,
  "count": 2,
  "contacts": [
    {"name": "John Smith", "email": "john.s@...", "phone": "..."},
    {"name": "John Doe", "email": "john.d@...", "phone": "..."}
  ]
}

設定

連絡先ファイルを作成するか、データソースのパスを設定します：

// ~/contacts.json
{
  "contacts": [
    {
      "name": "John Smith",
      "email": "[email protected]",
      "phone": "+1234567890"
    }
  ]
}

スキル内の検索パスを、お使いの設定に合わせて更新します。

統合

他のスキル（zoom-meeting、whatsapp）は、このスキルを使用して連絡先を検索します。このスキルを利用できない場合、他のスキルはユーザーに連絡先情報を直接尋ねます。