Connect Needle to Your AI Agent

Ask your AI assistant to work with Needle: retrieve Relevant Content from Collections.

7 tools API key

Try a Needle Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Needle

Retrieve evidence for a question

Search a specific collection for relevant content.

/oo Needle: Search Needle collection [collection ID] for [question], then summarize the retrieved evidence and distinguish it from inference.

Inspect indexing progress

Read collection statistics and attached file records.

/oo Needle: Read statistics and files for Needle collection [collection ID] and summarize the returned indexing status.

Start Working with Needle

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Needle

    Connect using your Needle API Key.

    Connect Needle →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • An account with access to the Needle resources used in your task.

Needle Tools

Needle lets an AI assistant import URL-backed files into collections and retrieve relevant indexed content.

Retrieve evidence for a question

Search a specific collection for relevant content.

Inspect indexing progress

Read collection statistics and attached file records.

7 tools

List Collections

List the Needle collections that the API key can access.

needle.list_collections

Create Collection

Create a Needle collection and optionally attach existing Needle file IDs.

needle.create_collection

Get Collection

Get the details of a single Needle collection.

needle.get_collection

Get Collection Stats

Get indexing and storage statistics for a Needle collection.

needle.get_collection_stats

List Collection Files

List the files currently attached to a Needle collection.

needle.list_collection_files

Add Files To Collection

Import one or more URL-backed files into a Needle collection for indexing.

needle.add_files_to_collection

Search Collection

Search a Needle collection for the most relevant retrieved content.

needle.search_collection

Frequently Asked Questions

Does search return complete files?

search_collection returns relevant retrieved content; do not treat snippets as a complete file export.

How are files imported?

add_files_to_collection imports URL-backed files into a specified collection for indexing.

Is an imported file immediately searchable?

Indexing can have a separate processing state. Inspect collection statistics and file records before relying on retrieval.

Connect Needle

About Needle ↗