mirror of
https://github.com/simstudioai/sim.git
synced 2026-04-28 03:00:29 -04:00
* feat(tools): added calcom * added more triggers, tested * updated regex in script for release to be more lenient * fix(tag-dropdown): performance improvements and scroll bug fixes - Add flatTagIndexMap for O(1) tag lookups (replaces O(n²) findIndex calls) - Memoize caret position calculation to avoid DOM manipulation on every render - Use refs for inputValue/cursorPosition to keep handleTagSelect callback stable - Change itemRefs from index-based to tag-based keys to prevent stale refs - Fix scroll jump in nested folders by removing scroll reset from registerFolder - Add onFolderEnter callback for scroll reset when entering folder via keyboard - Disable keyboard navigation wrap-around at boundaries - Simplify selection reset to single effect on flatTagList.length change Also: - Add safeCompare utility for timing-safe string comparison - Refactor webhook signature validation to use safeCompare Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * updated types * fix(calcom): simplify required field constraints for booking attendee The condition field already restricts these to calcom_create_booking, so simplified to required: true. Per Cal.com API docs, email is optional while name and timeZone are required. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * added tests * updated folder multi select, updated calcom and github tools and docs generator script * updated drag, updated outputs for tools, regen docs with nested docs script * updated setup instructions links, destructure trigger outputs, fix text subblock styling * updated docs gen script * updated docs script * updated docs script * updated script * remove destructuring of stripe webhook * expanded wand textarea, updated calcom tools --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
171 lines
8.3 KiB
Plaintext
171 lines
8.3 KiB
Plaintext
---
|
|
title: Exa
|
|
description: Search with Exa AI
|
|
---
|
|
|
|
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
|
|
|
<BlockInfoCard
|
|
type="exa"
|
|
color="#1F40ED"
|
|
/>
|
|
|
|
{/* MANUAL-CONTENT-START:intro */}
|
|
[Exa](https://exa.ai/) is an AI-powered search engine designed specifically for developers and researchers, providing highly relevant and up-to-date information from across the web. It combines advanced semantic search capabilities with AI understanding to deliver more accurate and contextually relevant results than traditional search engines.
|
|
|
|
With Exa, you can:
|
|
|
|
- **Search with natural language**: Find information using conversational queries and questions
|
|
- **Get precise results**: Receive highly relevant search results with semantic understanding
|
|
- **Access up-to-date information**: Retrieve current information from across the web
|
|
- **Find similar content**: Discover related resources based on content similarity
|
|
- **Extract webpage contents**: Retrieve and process the full text of web pages
|
|
- **Answer questions with citations**: Ask questions and receive direct answers with supporting sources
|
|
- **Perform research tasks**: Automate multi-step research workflows to gather, synthesize, and summarize information
|
|
|
|
In Sim, the Exa integration allows your agents to search the web for information, retrieve content from specific URLs, find similar resources, answer questions with citations, and conduct research tasks—all programmatically through API calls. This enables your agents to access real-time information from the internet, enhancing their ability to provide accurate, current, and relevant responses. The integration is particularly valuable for research tasks, information gathering, content discovery, and answering questions that require up-to-date information from across the web.
|
|
{/* MANUAL-CONTENT-END */}
|
|
|
|
|
|
## Usage Instructions
|
|
|
|
Integrate Exa into the workflow. Can search, get contents, find similar links, answer a question, and perform research.
|
|
|
|
|
|
|
|
## Tools
|
|
|
|
### `exa_search`
|
|
|
|
Search the web using Exa AI. Returns relevant search results with titles, URLs, and text snippets.
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `query` | string | Yes | The search query to execute |
|
|
| `numResults` | number | No | Number of results to return \(default: 10, max: 25\) |
|
|
| `useAutoprompt` | boolean | No | Whether to use autoprompt to improve the query \(default: false\) |
|
|
| `type` | string | No | Search type: neural, keyword, auto or fast \(default: auto\) |
|
|
| `includeDomains` | string | No | Comma-separated list of domains to include in results |
|
|
| `excludeDomains` | string | No | Comma-separated list of domains to exclude from results |
|
|
| `category` | string | No | Filter by category: company, research paper, news, pdf, github, tweet, personal site, linkedin profile, financial report |
|
|
| `text` | boolean | No | Include full text content in results \(default: false\) |
|
|
| `highlights` | boolean | No | Include highlighted snippets in results \(default: false\) |
|
|
| `summary` | boolean | No | Include AI-generated summaries in results \(default: false\) |
|
|
| `livecrawl` | string | No | Live crawling mode: never \(default\), fallback, always, or preferred \(always try livecrawl, fall back to cache if fails\) |
|
|
| `apiKey` | string | Yes | Exa AI API Key |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `results` | array | Search results with titles, URLs, and text snippets |
|
|
| ↳ `title` | string | The title of the search result |
|
|
| ↳ `url` | string | The URL of the search result |
|
|
| ↳ `publishedDate` | string | Date when the content was published |
|
|
| ↳ `author` | string | The author of the content |
|
|
| ↳ `summary` | string | A brief summary of the content |
|
|
| ↳ `favicon` | string | URL of the site's favicon |
|
|
| ↳ `image` | string | URL of a representative image from the page |
|
|
| ↳ `text` | string | Text snippet or full content from the page |
|
|
| ↳ `score` | number | Relevance score for the search result |
|
|
|
|
### `exa_get_contents`
|
|
|
|
Retrieve the contents of webpages using Exa AI. Returns the title, text content, and optional summaries for each URL.
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `urls` | string | Yes | Comma-separated list of URLs to retrieve content from |
|
|
| `text` | boolean | No | If true, returns full page text with default settings. If false, disables text return. |
|
|
| `summaryQuery` | string | No | Query to guide the summary generation |
|
|
| `subpages` | number | No | Number of subpages to crawl from the provided URLs |
|
|
| `subpageTarget` | string | No | Comma-separated keywords to target specific subpages \(e.g., "docs,tutorial,about"\) |
|
|
| `highlights` | boolean | No | Include highlighted snippets in results \(default: false\) |
|
|
| `livecrawl` | string | No | Live crawling mode: never \(default\), fallback, always, or preferred \(always try livecrawl, fall back to cache if fails\) |
|
|
| `apiKey` | string | Yes | Exa AI API Key |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `results` | array | Retrieved content from URLs with title, text, and summaries |
|
|
| ↳ `url` | string | The URL that content was retrieved from |
|
|
| ↳ `title` | string | The title of the webpage |
|
|
| ↳ `text` | string | The full text content of the webpage |
|
|
| ↳ `summary` | string | AI-generated summary of the webpage content |
|
|
|
|
### `exa_find_similar_links`
|
|
|
|
Find webpages similar to a given URL using Exa AI. Returns a list of similar links with titles and text snippets.
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `url` | string | Yes | The URL to find similar links for |
|
|
| `numResults` | number | No | Number of similar links to return \(default: 10, max: 25\) |
|
|
| `text` | boolean | No | Whether to include the full text of the similar pages |
|
|
| `includeDomains` | string | No | Comma-separated list of domains to include in results |
|
|
| `excludeDomains` | string | No | Comma-separated list of domains to exclude from results |
|
|
| `excludeSourceDomain` | boolean | No | Exclude the source domain from results \(default: false\) |
|
|
| `highlights` | boolean | No | Include highlighted snippets in results \(default: false\) |
|
|
| `summary` | boolean | No | Include AI-generated summaries in results \(default: false\) |
|
|
| `livecrawl` | string | No | Live crawling mode: never \(default\), fallback, always, or preferred \(always try livecrawl, fall back to cache if fails\) |
|
|
| `apiKey` | string | Yes | Exa AI API Key |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `similarLinks` | array | Similar links found with titles, URLs, and text snippets |
|
|
| ↳ `title` | string | The title of the similar webpage |
|
|
| ↳ `url` | string | The URL of the similar webpage |
|
|
| ↳ `text` | string | Text snippet or full content from the similar webpage |
|
|
| ↳ `score` | number | Similarity score indicating how similar the page is |
|
|
|
|
### `exa_answer`
|
|
|
|
Get an AI-generated answer to a question with citations from the web using Exa AI.
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `query` | string | Yes | The question to answer |
|
|
| `text` | boolean | No | Whether to include the full text of the answer |
|
|
| `apiKey` | string | Yes | Exa AI API Key |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `answer` | string | AI-generated answer to the question |
|
|
| `citations` | array | Sources and citations for the answer |
|
|
| ↳ `title` | string | The title of the cited source |
|
|
| ↳ `url` | string | The URL of the cited source |
|
|
| ↳ `text` | string | Relevant text from the cited source |
|
|
|
|
### `exa_research`
|
|
|
|
Perform comprehensive research using AI to generate detailed reports with citations
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `query` | string | Yes | Research query or topic |
|
|
| `model` | string | No | Research model: exa-research-fast, exa-research \(default\), or exa-research-pro |
|
|
| `apiKey` | string | Yes | Exa AI API Key |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `research` | array | Comprehensive research findings with citations and summaries |
|
|
|
|
|