SKILLKnowledge Workproductivity

update-contact

プラグイン: carta-crm
ソース: GitHub で見る ↗

説明

Carta CRM（営業管理システム）に登録されている既存の人物の連絡先情報を更新します。 **次のような場合に使用:** - 「連絡先を更新して」 - 「連絡先を編集して」 - 「連絡先の詳細を変更して」 - 「連絡先のメールアドレスを変更して」 - 「人物の役職を更新して」 - 「連絡先の会社を更新して」 - 「連絡先にタグを追加して」 - 「/update-contact」というコマンド連絡先ID（識別番号）または名前で対象を指定できます。IDが指定されていない場合は自動で検索します。指定された項目のみが更新され、その他の項目は変更されません。

原文を表示

Updates an existing contact (person) record in the Carta CRM. Use this skill when the user says things like "update a contact", "edit contact", "update contact details", "change contact email", "update person's title", "update contact company", "add a tag to contact", or "/update-contact". Accepts a contact ID or name (will search if no ID provided). Only the fields explicitly provided are changed — all other fields are left untouched.

ユースケース

連絡先情報を更新したい
連絡先を編集したい
メールアドレスを変更したい
人物の役職を更新したい
連絡先にタグを追加したい

本文（日本語訳）

<carta-plugin>carta-crm:1.14.2</carta-plugin>

概要

既存の連絡先情報を部分的に更新します。指定されたフィールドのみが変更され、全体の置き換えではありません。まず連絡先IDを特定し、変更内容を確認してから更新ツールを呼び出します。

ステップ1：連絡先IDを特定する

ユーザーが連絡先IDを直接提供した場合は、それを使用してステップ3へ進みます。

名前や説明のみが提供された場合は、まず検索します：

crm_call_tool({ "name": "crm:search_contacts", "arguments": { query: "<name>", limit: 10 } })

複数の連絡先が該当する場合は、リストを表示して、どの連絡先を更新するか確認を求めてください（各連絡先の名前、職務、会社、IDを表示）。

ステップ2：変更内容を確認する

ユーザーに何を変更したいかを尋ねます。更新可能なフィールドは以下の通りです：

フィールド	説明
`name`	氏名
`firstName`、`lastName`、`middleName`	名前の各部分
`emailDetail`	主要メールアドレス；Second/Third/Fourth で追加メール
`phone`	主要電話番号；`businessPhone` で勤務先電話番号
`title`	職務経歴
`headline`	簡潔な自己紹介やキャッチフレーズ
`location`	勤務地（市区町村、都道府県、国）
`homeLocation`	自宅所在地（市区町村、都道府県、国）
`socialLinks`	linkedinUrl、twitterUrl、githubUrl、facebookUrl
`jobs`	職務経歴の配列 — 既存の職務経歴を完全に置き換え
`tags`	タグの配列 — 既存タグを完全に置き換え
`notes`	自由形式の注記
`fields`	カスタムフィールドの値（フィールドIDをキーとする）

ユーザーがカスタムフィールドを更新したいが、フィールドIDが不明な場合は、まずスキーマを取得してください：

crm_call_tool({ "name": "crm:get_contact_custom_fields", "arguments": {} })

重要： 明示的に変更するフィールドのみを含めてください。その他は省略します。

ステップ3：連絡先を更新する

次を呼び出します：

crm_call_tool({
  "name": "crm:update_contact",
  "arguments": {
    id: "<contact id>",
    name: "<updated name>",
    title: "<updated title>",
    emailDetail: "<updated email>",
    tags: ["<tag1>", "<tag2>"],
    fields: { "<field_id>": "<value>" }
  }
})

更新されないキーは削除してください。

ステップ4：結果を報告する

成功時は、変更内容の要約を返します：

「連絡先 {name} を更新しました（ID: {id}）。変更項目：[変更されたフィールド一覧]」

エラーが発生した場合は、エラーメッセージを表示し、以下を提案してください：

連絡先IDが正しいか確認してください — /search-contacts で検索してください
カスタムフィールドIDが有効か確認してください

複数の連絡先を更新する場合

ユーザーが複数の連絡先に同じ変更を適用したい場合は、各連絡先についてステップ1と3〜4を繰り返してください。最後に要約を表示します：

「N件の連絡先を更新しました：[名前一覧]」

原文（English）を表示

<carta-plugin>carta-crm:1.14.5</carta-plugin>

Overview

Partially update an existing contact. Only fields provided are modified — this is a partial update, not a replacement. First resolve the contact ID, collect what to change, then call the update tool.

Step 1 — Resolve the contact ID

If the user provided a contact ID directly, use it and skip to Step 3.

If only a name or description was given, search first:

crm_call_tool({ "name": "crm:search_contacts", "arguments": { query: "<name>", limit: 10 } })

If multiple contacts match, present the list and ask the user to confirm which one to update (show name, title, company, and ID for each).

Step 2 — Collect what to update

Ask the user what they want to change. Updatable fields include:

Field	Description
`name`	Full name
`firstName`, `lastName`, `middleName`	Name parts
`emailDetail`	Primary email; Second/Third/Fourth for additional emails
`phone`	Primary phone; `businessPhone` for business number
`title`	Job title
`headline`	Short bio or tagline
`location`	Work location (city, state, country)
`homeLocation`	Home location (city, state, country)
`socialLinks`	linkedinUrl, twitterUrl, githubUrl, facebookUrl
`jobs`	Work experience array — fully replaces existing jobs
`tags`	Tags array — fully replaces existing tags
`notes`	Free-text notes
`fields`	Custom field values keyed by field ID

If the user wants to update custom fields but isn't sure of field IDs, fetch the schema first:

crm_call_tool({ "name": "crm:get_contact_custom_fields", "arguments": {} })

Important: Only include fields that are explicitly being changed. Omit everything else.

Step 3 — Update the contact

Call:

crm_call_tool({
  "name": "crm:update_contact",
  "arguments": {
    id: "<contact id>",
    name: "<updated name>",
    title: "<updated title>",
    emailDetail: "<updated email>",
    tags: ["<tag1>", "<tag2>"],
    fields: { "<field_id>": "<value>" }
  }
})

Omit any key that is not being updated.

Step 4 — Report result

On success, respond with a summary of what changed:

"Contact {name} updated (ID: {id}). Changed: [list of changed fields]"

On error, show the error message and suggest:

Verify the contact ID is correct — run /search-contacts to find it
Check that custom field IDs are valid

Updating multiple contacts

If the user wants to apply the same change to multiple contacts, repeat Steps 1 and 3–4 for each. Summarize at the end:

"Updated N contacts: [list of names]"

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。