> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alongagents.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# along

> Query your Safe's knowledge graph in natural language. Along routes your request to the right data source and returns a grounded answer.

## Overview

The `along` tool is your primary interface to Along's knowledge graph. Pass any natural language question or request, and Along routes it to the appropriate data source — knowledge base documents, meeting transcripts, CRM records, calendar data, or entity relationship graphs — and returns a grounded answer.

<Note>
  You must have a Safe selected via `along_select_safe` before calling this tool. If no Safe is selected, the tool returns an error with instructions to call `along_list_safes` first.
</Note>

## When to use

* Searching documents, transcripts, and uploaded files
* Querying CRM data (deals, contacts, companies)
* Finding meeting recordings or summaries by keyword, date, or participant
* Getting calendar availability or upcoming events
* Exploring how people, companies, and topics relate to each other in the knowledge graph

## Parameters

<ParamField body="request" type="string" required>
  The user's question or request in natural language. Pass it exactly as the user asked.
</ParamField>

## Capabilities

Along inspects your request and routes it to the right data source automatically.

<Tabs>
  <Tab title="Knowledge base">
    Searches documents, call summaries, transcripts, and uploaded files stored in the Safe.

    **Example requests**

    * "What did we discuss in the Q3 planning meeting?"
    * "Summarize our product roadmap"
    * "Find all notes about Project Phoenix"
  </Tab>

  <Tab title="Meetings">
    Searches meeting recordings and transcripts by keyword, date range, or participant name.

    **Example requests**

    * "Find meetings with Acme Corp from last month"
    * "What were the action items from yesterday's standup?"
    * "Show me calls where pricing was discussed"
  </Tab>

  <Tab title="CRM (HubSpot)">
    Queries HubSpot deals, contacts, companies, tasks, tickets, and recent engagements. Available when HubSpot is enabled for the Safe.

    **Example requests**

    * "What's the status of the Acme deal?"
    * "Show me open tasks"
    * "Who are my contacts at GlobalCorp?"
    * "Get pipeline stats"
  </Tab>

  <Tab title="Calendar (Google Calendar)">
    Queries upcoming events, searches calendar entries, and checks free/busy availability. Available when Google Calendar is enabled for the Safe.

    **Example requests**

    * "What's on my calendar today?"
    * "Find my next meeting with Sarah"
    * "Am I free Thursday afternoon?"
  </Tab>

  <Tab title="Knowledge graph">
    Explores entity relationships and connections between people, companies, topics, and documents.

    **Example requests**

    * "How is John Smith connected to the Acme deal?"
    * "What companies are related to Project Phoenix?"
    * "Show me the relationships around GlobalCorp"
  </Tab>
</Tabs>

## Response structure

The `along` tool returns a JSON text content block. If the active Safe has `instructions` configured, Along prepends an `[Instructions: ...]` block to the response so your AI assistant can apply them when formulating the final answer.

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[Instructions: Answer questions using only information in this Safe. Cite sources.]"
      },
      {
        "type": "text",
        "text": "{\"results\":[{\"title\":\"Q3 Planning Meeting - 2024-09-15\",\"excerpt\":\"The team agreed to prioritize the enterprise tier launch...\",\"sourceType\":\"transcript\",\"documentId\":\"doc_abc\"}],\"query\":\"Q3 planning meeting decisions\"}"
      }
    ]
  }
}
```

## Safe switching via natural language

You can also ask the `along` tool to switch Safes using natural language — you do not need to call `along_list_safes` or `along_select_safe` directly. Phrases like "switch safe", "change safe", "list safes", or "use a different knowledge base" trigger the built-in safe management flow.

## Error states

| Error message                     | Cause                                                                    |
| --------------------------------- | ------------------------------------------------------------------------ |
| `"No safe is currently selected"` | Call `along_list_safes` then `along_select_safe` before using this tool. |
| `"request is required"`           | The `request` argument was empty or missing.                             |

## Example

<CodeGroup>
  ```json Request theme={null}
  {
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "along",
      "arguments": {
        "request": "What were the key decisions from last week's product review?"
      }
    }
  }
  ```

  ```json Response theme={null}
  {
    "jsonrpc": "2.0",
    "id": 3,
    "result": {
      "content": [
        {
          "type": "text",
          "text": "[Instructions: Answer questions using only information in this Safe. Cite sources.]"
        },
        {
          "type": "text",
          "text": "{\"results\":[{\"title\":\"Product Review - 2024-09-15\",\"excerpt\":\"The team agreed to prioritize the enterprise tier launch and defer the mobile redesign to Q1.\",\"sourceType\":\"transcript\",\"documentId\":\"doc_abc\"}],\"query\":\"key decisions from last week's product review\"}"
        }
      ]
    }
  }
  ```
</CodeGroup>