find_experts
Identify the top experts in a channel for a given topic by ranking people based on knowledge graph signals and expertise scores.
Instructions
Rank the PEOPLE most knowledgeable about a topic in one channel.
Call this to answer "who should I ask about X in #channel?" or to
route a question to the right person. This is the only tool that
ranks PEOPLE; use search_channel_facts / find_facts to find
FACTS, and find_experts only when you specifically need a human.
Prerequisite: a channel_id from list_channels. Do NOT call
with a channel display name.
Returns (instant, read-only, no side effects):
{"experts": [...]} — a list ranked by expertise_score
descending. Each entry has handle (e.g. '@dana'),
expertise_score (relative float, higher = more authoritative;
not a fixed 0–1 scale, only meaningful for ranking within this
result), fact_count (number of contributing facts), and
top_topics (list of related topics that person engages with).
An empty list means no graph signal for that topic — not an error.
Error modes: {"error": "authentication_missing"} if the caller
is unauthenticated; {"error": "channel_access_denied", "channel_id": ...} if the principal cannot read the channel;
{"error": "invalid_parameter", ...} for a malformed
channel_id. Other backend failures degrade gracefully to
{"experts": []}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel_id | Yes | Required. The channel id to search within, obtained from list_channels (e.g. 'ch-eng'). Not a human channel name. | |
| topic | Yes | Required. Topic or keyword to rank experts on, e.g. 'kubernetes', 'billing', 'auth'. Matched against knowledge-graph edges, so use a concept the channel actually discusses. | |
| limit | No | Maximum number of experts to return. Range 1–20, default 5. Values outside the range are silently clamped (e.g. 50 -> 20, 0 -> 1). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||