# Overview

{% embed url="<https://www.loom.com/share/d7ca1d2ff60440fe914a21345e7c3c6f?sid=cbc36b56-d582-402c-a23c-5f4a363fa5f3>" %}

## What are Integry Functions?

Integry Functions lets you use Integry's extensive library of app functions as tools within your AI applications. By leveraging Integry's [function-calling](https://platform.openai.com/docs/guides/function-calling) compatible JSON structures, you can invoke third-party app functions directly from your AI calls. You can:

* Access hundreds of third-party app functions.
* Use function-calling compatible JSON structures in your AI calls.
* Show a populated form of the action for user editing and confirmation
* Invoke functions directly (headlessly i.e. without a UI)&#x20;
* Predict and populate functions based on user input.

[Sign up now](https://app.integry.io/accounts/register/v3/signup/?product=functions) for a free trial and follow [Quickstart for AI](/functions/quickstart-for-ai.md) to get started.

{% hint style="info" %}
Integry supports many functions for [200+ apps](https://www.integry.ai/apps). Click the **Marketplace** button in the app to browse the full list of Functions or [use the API](https://integry.gitbook.io/integry-docs/apis-and-sdks/api-reference#list-all-functions).
{% endhint %}

## Using Functions with Your AI

Generally, when using AI with function calling, you take the following steps:

1. **Collect User Input:** You collect a user message, which requires talking to an external API. For example: "<mark style="background-color:yellow;">send hello to my team on slack on #general</mark>"&#x20;
2. **Call AI Model:** You take the user message, their data context, and a prompt and pass a list of function specs with to the AI's API call
3. **AI Populates Function:** The AI selects the function, fills in its parameters, and returns the result
4. **Call Function:** You then call the function with the arguments and take next steps based on the response
5. **Validate Arguments (optional):** before calling the function in step 3, you might need to validate the user input. In our example, the user wrote #general whereas the actual channel was #general. To resolve this, you may need to first fetch all channels and find the closest match
6. **Show UI (optional):** you could also show the user the final function call in a UI before executing it.&#x20;

To achieve this, we have two methods. The first method is faster and easier to start with. The second method requires more effort but provides greater control. Here they are:

1. **Function Prediction**: Pass the user message to`/functions/?predict_function=true&prompt=<user_message>` to get the most relevant function. You can also get populated arguments.
2. **Function List Retrieval**: Retrieve a list of available functions using the `/functions` endpoint and pass them to your AI model. Your model will predict the function to use and will populate the arguments. You may need to validate your inputs with additional supporting function calls.

Both approaches converge after obtaining the function parameters, where you can choose to call the function directly or show  the UI.

{% @mermaid/diagram content="graph TD
B{Choose Approach} --> |Function Prediction| C\[Pass user message
to get a predicted function]
C --> D\[Receive function
with parameters
and supporting functions]
C --> |with predict\_arguments=true| E\[Receive function
with arguments]
E --> K
B --> |Function Retrieval| F\[Get all functions
or user-connected
app functions]
F --> D
D --> DD\[Use LLM to pick
primary function]
DD --> I\[Optional: Call supporting
functions headlessly]:::optional
I -.-> I
I -.-> J\[Optional: Use LLM to map
user input to
supporting data]:::optional
J --> K{ }
K --> |Headless| L\[Invoke Function]
K -.-> |UI| M\[Optional: Show UI]:::optional
M -.-> L
L --> N\[Receive return from API]

```
classDef optional stroke:#333,stroke-dasharray: 5 5;
```

" %}

## Additional Resources

* [OpenAI Function Calling Documentation](https://platform.openai.com/docs/guides/function-calling)
* [Integry API Reference](/apis-and-sdks/api-reference.md)
* [Integry.JS SDK Reference](/apis-and-sdks/js-sdk-reference.md)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.integry.ai/functions/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.