> For the complete documentation index, see [llms.txt](https://agpt.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://agpt.co/docs/integrations/block-integrations/code_context.md).

# Exa Code Context

Blocks for searching code repositories and documentation using Exa's code context API.

## Exa Code Context

### What it is

Legacy: Exa no longer documents its code context API; for new workflows use the Exa Search block, which Exa's Code & Docs guide recommends (e.g. type 'lite' with highlights). Searches GitHub repos, docs and Stack Overflow for relevant code examples.

### How it works

This block sends your query to Exa's `/context` endpoint, which Exa no longer documents: it is missing from Exa's API spec and its reference page redirects to the Code & Docs search guide. The block is kept so saved workflows keep running; for new workflows, use the Exa Search block (for example type 'lite' with highlights), as that guide recommends.

The endpoint returns one formatted string of code snippets and examples with their sources from GitHub repositories, documentation and Stack Overflow, plus the result count, search time, output token count and cost. Tokens Num sets the response size: 'dynamic' (default) or a token count such as 5000 or 10000. The run is billed from the dollar cost Exa reports, at 150 credits per US dollar.

### Inputs

| Input       | Description                                                                                                                                                                          | Type       | Required |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | -------- |
| query       | Search query to find relevant code snippets. Describe what you're trying to do or what code you're looking for.                                                                      | str        | Yes      |
| tokens\_num | Token limit for response. Use 'dynamic' for automatic sizing, 5000 for standard queries, or 10000 for comprehensive examples. (In Exa Search the equivalent is text max characters.) | str \| int | No       |

### Outputs

| Output         | Description                                                  | Type  |
| -------------- | ------------------------------------------------------------ | ----- |
| error          | Error message if the operation failed                        | str   |
| request\_id    | Unique identifier for this request                           | str   |
| query          | The search query used                                        | str   |
| response       | Formatted code snippets and contextual examples with sources | str   |
| results\_count | Number of code sources found and included                    | int   |
| cost\_dollars  | Cost of this request in dollars                              | str   |
| search\_time   | Time taken to search in milliseconds                         | float |
| output\_tokens | Number of tokens in the response                             | int   |

### Possible use case

**API Integration Examples**: Find real-world code examples showing how to integrate with specific APIs or libraries.

**Debugging Assistance**: Search for code patterns related to error messages or specific programming challenges.

**Learning New Technologies**: Discover implementation examples when learning a new framework or programming language.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://agpt.co/docs/integrations/block-integrations/code_context.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
