Overview
Gorkie can search the web using the Exa search engine to find current information, news, documentation, and articles. This capability allows Gorkie to answer questions about recent events, look up API documentation, and retrieve content from the internet.
How Web Search Works
Gorkie automatically decides when to use web search based on the conversation context. You can also explicitly request a search.
From server/lib/ai/tools/chat/search-web.ts:16-42:
export const searchWeb = ({
stream,
}: {
context: SlackMessageContext;
stream: Stream;
}) =>
tool({
description:
'Search the web for code docs, current information, news, articles, and content. Use this when you need up-to-date information or facts from the internet.',
inputSchema: z.object({
query: z
.string()
.min(1)
.max(500)
.describe(
"The web search query. Be specific and clear about what you're looking for."
),
}),
onInputStart: async ({ toolCallId }) => {
await createTask(stream, {
taskId: toolCallId,
title: 'Searching the web',
status: 'pending',
});
},
execute: async ({ query }, { toolCallId }) => {
// ... search execution
},
});
Gorkie uses web search when you ask about current events, recent releases, documentation, or any information that requires up-to-date knowledge.
Search Configuration
Gorkie uses Exa’s “auto” search type, which automatically determines the best search strategy.
From server/lib/ai/tools/chat/search-web.ts:8-14:
const EXA_SEARCH_OPTIONS = {
type: 'auto',
numResults: 10,
contents: {
text: true,
},
} as const satisfies RegularSearchOptions;
- Type:
auto - Exa decides between neural and keyword search
- Results: 10 results per search
- Contents: Text content included (for reading and summarization)
Exa Integration
The Exa client is initialized with an API key.
From server/lib/ai/exa.ts:1-5:
import Exa from 'exa-js';
import { env } from '~/env';
export const exa = new Exa(env.EXA_API_KEY);
Search Execution
From server/lib/ai/tools/chat/search-web.ts:49-72:
try {
const result = await exa.search(query, EXA_SEARCH_OPTIONS);
const sources: TaskSource[] = result.results
.map((item) => {
const url = item.url?.trim();
if (!url) {
return undefined;
}
return {
type: 'url',
text: item.title || url,
url,
};
})
.filter((source): source is TaskSource => Boolean(source))
.slice(0, 8);
await finishTask(stream, {
status: 'complete',
taskId: task,
sources,
output: `Searched the web for "${query}" and found *${sources.length} source${sources.length === 1 ? '' : 's'}*.`,
});
return result;
}
- URL of each result
- Title of the page
- Full text content (up to Exa’s limits)
- Up to 8 sources displayed in Slack
When Gorkie Uses Search
Gorkie’s system prompt includes guidance on search usage:
Limitations:
- You CANNOT browse the web directly. Use the searchWeb tool to find information instead.
- If a user asks to download/convert/extract content from a PUBLIC URL, use the sandbox tool.
- You ask about current events or news
- You need recent documentation or API references
- You request information not in its training data
- You explicitly ask it to search
Search Capabilities
Code Documentation
@gorkie search for React 19 migration guide
@gorkie what are the latest features in Python 3.13?
News and Articles
@gorkie find articles about WebAssembly performance
API References
@gorkie how does the Stripe Checkout API work?
Search Results Display
Search results appear in Slack as task completion messages with source links:
Searched the web for "React 19 migration guide" and found 8 sources.
Sources:
- React 19 Release Notes (https://react.dev/blog/2024/...)
- Migration Guide (https://react.dev/blog/2024/...)
- ...
Best Practices
- Be specific - “React 19 hooks changes” is better than “React updates”
- Use keywords - Include technical terms for better results
- Combine with sandbox - Search for docs, then use sandbox to try examples
- Trust Gorkie - It knows when search is needed and will use it automatically
If Gorkie’s search doesn’t find what you need, try rephrasing your question with different keywords or being more specific about what you’re looking for.
Limitations
What Search CAN Do
- Find public web content
- Access documentation sites
- Retrieve articles and blog posts
- Get current information
What Search CANNOT Do
- Access authenticated/private content
- Log into websites
- Access paywalled articles
- Retrieve content behind login screens
From the system prompt:
You CANNOT log in to websites, authenticate, or access anything behind auth
(GitHub repos, Google Docs, Jira, private APIs, etc.).
Error Handling
If a search fails, Gorkie will:
- Mark the task as error
- Log the error details
- Inform you that the search failed
- Try to help using its existing knowledge
From server/lib/ai/tools/chat/search-web.ts:73-77:
catch (error) {
await finishTask(stream, { status: 'error', taskId: task });
throw error;
}