Core Concepts

AI Chat

AI Chat

Voyager includes an AI assistant powered by Claude that can query LinkedIn on your behalf using natural language.

How it works

  1. You send a message like “who are my colleagues?” or “find Cambridge alumni at Google”
  2. The AI agent decides which Voyager tools to call (profile lookup, SalesNav search, etc.)
  3. It streams the response back with tool call indicators and formatted results

Endpoint

$POST /api/chat
$Content-Type: application/json
$Authorization: Bearer voy_...
$X-User-Id: charis
$
${ "message": "find ex-Barclays people who moved to France" }

The response is Server-Sent Events (SSE) with these event types:

EventDescription
text-deltaStreaming text chunk from the AI
tool-startAI is calling a tool (e.g., “Searching people…”)
tool-resultTool returned results
doneResponse complete, includes threadId
errorSomething went wrong

Thread Management

Conversations are persistent per thread. Pass threadId to continue a conversation:

1{ "message": "now filter those by London", "threadId": "tenant123:charis" }

List threads: GET /api/chat/threads

What the AI can do

The agent has access to 35+ tools including:

  • Profile lookup — own profile, any profile, contact info, skills, network stats
  • People search — by keywords, company ID, connection degree
  • SalesNav search — 22 structured filters (school, company, title, geography, industry, seniority)
  • Messaging — send messages, view conversations
  • Engagement — like posts, comment, create posts
  • Companies — company info, employees, posts
  • Network — connections, pending invitations, relationship status

Example queries

QueryWhat happens
”what’s my profile?”Calls get_my_profile
”who are my colleagues?”Gets profile → extracts company ID → searches employees
”find Cambridge alumni at Anthropic”SalesNav search with SCHOOL + CURRENT_COMPANY filters
”find my ex-colleagues who moved to France”Gets all company IDs → SalesNav PAST_COMPANY + REGION
”find CTOs at fintech startups in Berlin”SalesNav CURRENT_TITLE + INDUSTRY + REGION + COMPANY_HEADCOUNT
”send a message to John”Searches for John → confirms with you → sends message

Configuration

The chat requires ANTHROPIC_API_KEY environment variable. Without it, the endpoint returns 503.

The AI uses Claude Sonnet 4 with streaming and can chain up to 10 tool calls per message.