Skip to content

Commit

Permalink
wip: complete integration pages
Browse files Browse the repository at this point in the history
  • Loading branch information
Vedantsahai18 committed Jan 17, 2025
1 parent 3470cbd commit 0764f3b
Show file tree
Hide file tree
Showing 18 changed files with 809 additions and 62 deletions.
2 changes: 1 addition & 1 deletion documentation/docs/advanced/files.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Files (Multimedia)'
description: 'Learn about file handling and management in Julep'
icon: 'box-archive'
icon: 'file-circle-plus'
---

Coming soon...
Expand Down
2 changes: 1 addition & 1 deletion documentation/docs/concepts/docs.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Documents (RAG)'
description: 'Working with documents in Julep'
icon: 'file'
icon: 'database'
---

Learn about document management and storage in Julep.
Expand Down
82 changes: 81 additions & 1 deletion documentation/docs/integrations/communication/email.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,85 @@ description: 'Learn how to use the Email integration with Julep'
icon: 'envelope'
---

Welcome to the Email integration guide for Julep! This integration allows you to send emails using SMTP, enabling you to build workflows that require email communication capabilities. Whether you're sending notifications or managing email campaigns, this guide will walk you through the setup and usage.

Coming soon...
## Prerequisites

<Info type="info" title="SMTP Server Credentials Required">
To use the Email integration, you need SMTP server credentials, including the host, port, username, and password. Ensure you have access to an SMTP server before proceeding.
</Info>

## How to Use the Integration

To get started with the Email integration, follow these steps to configure and create a task:

<Steps>
<Step title="Configure Your SMTP Server">
Add your SMTP server credentials to the Julep dashboard under the integrations section. This will allow Julep to authenticate requests to your email server on your behalf.
</Step>
<Step title="Create Task Definition">
Use the following YAML configuration to define your email sending task:

```yaml Email Example
name: Email Task
tools:
- name: email_tool
type: integration
integration:
provider: email
setup:
host: "smtp.example.com"
port: 587
user: "your_username"
password: "your_password"
main:
- tool: email_tool
arguments:
to: "[email protected]"
from: "[email protected]"
subject: "Hello from Julep"
body: "This is a test email sent using Julep's Email integration."
```
</Step>
</Steps>
### YAML Explanation
<AccordionGroup>
<Accordion title="Basic Configuration">
- **_name_**: A descriptive name for the task, in this case, "Email Task".
- **_tools_**: This section lists the tools or integrations being used. Here, `email_tool` is defined as an integration tool.
</Accordion>

<Accordion title="Tool Configuration">
- **_type_**: Specifies the type of tool, which is `integration` in this context.
- **_integration_**: Details the provider and setup for the integration.
- **_provider_**: Indicates the service provider, which is `email` for Email integration.
- **_setup_**: Contains configuration details, such as the SMTP server credentials.
</Accordion>

<Accordion title="Workflow Configuration">
- **_main_**: Defines the main execution steps.
- **_tool_**: Refers to the tool defined earlier (`email_tool`).
- **_arguments_**: Specifies the input parameters for the tool:
- **_to_**: The email address to send the email to.
- **_from_**: The email address to send the email from.
- **_subject_**: The subject of the email.
- **_body_**: The body of the email.
</Accordion>
</AccordionGroup>

<Note>
Remember to replace the SMTP server credentials and email addresses with your actual information. Ensure your SMTP server allows sending emails from the specified addresses.
</Note>

## Conclusion

With the Email integration, you can efficiently send emails using SMTP.
This integration provides a robust solution for email communication, enhancing your workflow's capabilities and user experience.

For further assistance, feel free to reach out to our support team or consult the [SMTP documentation](https://docs.python.org/3/library/smtplib.html).

<Callout type="success" title="Need Help?">
If you encounter any issues or have questions, our support team is here to help. Don't hesitate to reach out!
</Callout>
70 changes: 69 additions & 1 deletion documentation/docs/integrations/data-services/arxiv.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,72 @@ description: 'Learn how to use the ArXiv integration with Julep'
icon: 'book'
---

Coming soon...
Welcome to the ArXiv integration guide for Julep! This integration allows you to access a vast repository of scientific papers and articles, enabling you to build workflows that require academic research data. Whether you're developing a research assistant or need scholarly articles for analysis, this guide will walk you through the setup and usage.

## How to Use the Integration

To get started with the ArXiv integration, follow these steps to configure and create a task:

<Steps>
<Step title="Define Your Search Parameters">
Use the following YAML configuration to define your search parameters and request data from ArXiv:

```yaml ArXiv Search Example
name: ArXiv Search
tools:
- name: arxiv_search
type: integration
integration:
provider: arxiv
main:
- tool: arxiv_search
arguments:
query: "machine learning"
max_results: 10
download_pdf: False
sort_by: "relevance"
sort_order: "descending"
```
</Step>
</Steps>
### YAML Explanation
<AccordionGroup>
<Accordion title="Basic Configuration">
- **_name_**: A descriptive name for the task, in this case, "ArXiv Search".
- **_tools_**: This section lists the tools or integrations being used. Here, `arxiv_search` is defined as an integration tool.
</Accordion>

<Accordion title="Tool Configuration">
- **_type_**: Specifies the type of tool, which is `integration` in this context.
- **_integration_**: Details the provider and setup for the integration.
- **_provider_**: Indicates the service provider, which is `arxiv` for ArXiv.
</Accordion>

<Accordion title="Workflow Configuration">
- **_main_**: Defines the main execution steps.
- **_tool_**: Refers to the tool defined earlier (`arxiv_search`).
- **_arguments_**: Specifies the input parameters for the tool:
- **_query_**: The search query for the ArXiv search.
- **_max_results_**: (optional) The maximum number of results to return. Defaults to 5.
- **_download_pdf_**: (optional) Return base64 encoded pdfs. Defaults to False.
- **_sort_by_**: (optional) The sorting criterion for the results. Defaults to "relevance".
- **_sort_order_**: (optional) The sorting order for the results. Defaults to "descending".
</Accordion>
</AccordionGroup>

<Note>
Customize the `query` and other parameters to suit your specific search needs.
</Note>

## Conclusion

With the ArXiv integration, you can easily access a wealth of academic papers and articles.
This integration provides a robust solution for accessing scholarly data, enhancing your workflow's research capabilities and user experience.

For further assistance, feel free to reach out to our support team or consult the [ArXiv API documentation](https://arxiv.org/help/api/index).

<Callout type="success" title="Need Help?">
If you encounter any issues or have questions, our support team is here to help. Don't hesitate to reach out!
</Callout>
34 changes: 19 additions & 15 deletions documentation/docs/integrations/data-services/weather.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: 'OpenWeatherMap integration with Julep'
icon: 'cloud-sun-rain'
---

Welcome to the OpenWeatherMap integration guide for Julep! This integration allows you to seamlessly access weather data for various locations, enabling you to build applications that require real-time weather information.
Welcome to the OpenWeatherMap integration guide for Julep! This integration allows you to seamlessly access weather data for various locations, enabling you to build workflows that require real-time weather information.

## Prerequisites

Expand All @@ -14,7 +14,7 @@ Welcome to the OpenWeatherMap integration guide for Julep! This integration allo

## How to Use the Integration

To get started with the OpenWeatherMap integration, follow these steps to configure and make requests:
To get started with the OpenWeatherMap integration, follow these steps to configure and create a task:

<Steps>
<Step title="Configure Your API key">
Expand All @@ -38,29 +38,33 @@ To get started with the OpenWeatherMap integration, follow these steps to config
location: "London"
```
</Step>
<Step title="Run Task">
Deploy your task by creating a new execution.
</Step>
</Steps>
### YAML Explanation
<AccordionGroup>
<Accordion title="Basic Configuration">
- **name**: A descriptive name for the task, in this case, "Weather Request".
- **tools**: This section lists the tools or integrations being used. Here, `weather_call` is defined as an integration tool.
- **_name_**: A descriptive name for the task, in this case, "Weather Request".
- **_tools_**: This section lists the tools or integrations being used. Here, `weather_call` is defined as an integration tool.
</Accordion>

<Accordion title="Tool Configuration">
- **type**: Specifies the type of tool, which is `integration` in this context.
- **integration**: Details the provider and setup for the integration.
- **provider**: Indicates the service provider, which is `weather` for OpenWeatherMap.
- **method**: Specifies the method to be used. Default is `weather` if not specified.
- **setup**: Contains configuration details, such as the API key (`openweathermap_api_key`) required for authentication.
- **_type_**: Specifies the type of tool, which is `integration` in this context.
- **_integration_**: Details the provider and setup for the integration.
- **_provider_**: Indicates the service provider, which is `weather` for OpenWeatherMap.
- **_method_**: Specifies the method to be used. Default is `weather` if not specified.
- **_setup_**: Contains configuration details, such as the API key (`openweathermap_api_key`) required for authentication.
</Accordion>

<Accordion title="Execution Configuration">
- **main**: Defines the main execution steps.
- **tool**: Refers to the tool defined earlier (`weather_call`).
- **arguments**: Specifies the parameters for the request, such as the `location` for which weather data is needed.
<Accordion title="Workflow Configuration">
- **_main_**: Defines the main execution steps.
- **_tool_**: Refers to the tool defined earlier (`weather_call`).
- **_arguments_**: Specifies the input parameters for the tool:
- **_location_**: The location for which weather data is needed.

</Accordion>
</AccordionGroup>

Expand All @@ -70,7 +74,7 @@ To get started with the OpenWeatherMap integration, follow these steps to config

## Conclusion

With the OpenWeatherMap integration, you can easily incorporate weather data into your applications.
With the OpenWeatherMap integration, you can easily incorporate weather data into your workflows.
This integration provides a robust solution for accessing real-time weather information, enhancing your workflow's functionality and user experience.

For further assistance, feel free to reach out to our support team or consult the [OpenWeatherMap API documentation](https://openweathermap.org/api).
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,100 @@
---
title: 'Llama Parse'
description: 'Learn how to use the Llama Parse integration with Julep'
icon: 'file'
icon: 'file-pdf'
---

Coming soon...
Welcome to the Llama Parse integration guide for Julep! This integration allows you to parse documents efficiently, enabling you to build workflows that require document processing capabilities. Whether you're developing a document management system or need to extract information from files, this guide will walk you through the setup and usage.

## Prerequisites

<Info type="info" title="API Key Required">
To use the Llama Parse integration, you need an API key. You can obtain this key by signing up at [Llama Parse](https://llamaparse.com/signup).
</Info>

## How to Use the Integration

To get started with the Llama Parse integration, follow these steps to configure and create a task:

<Steps>
<Step title="Configure Your API Key">
Add your API key to the Julep dashboard under the integrations section. This will allow Julep to authenticate requests to Llama Parse on your behalf.
</Step>
<Step title="Create Task Definition">
Use the following YAML configuration to define your document parsing task:

```yaml Llama Parse Example
name: Llama Parse Task
tools:
- name: llama_parse
type: integration
integration:
provider: llama-parse
setup:
llamaparse_api_key: {llamaparse_api_key}
params: # Optional setup parameters
key1: value1
key2: value2
main:
- tool: llama_parse
arguments:
file: "base64_encoded_file"
filename: "document.pdf"
base64: true
params: # Optional arguments parameters
key3: value3
key4: value4
```
</Step>
<Step title="Run Task">
Deploy your task by creating a new execution.
</Step>
</Steps>
### YAML Explanation
<AccordionGroup>
<Accordion title="Basic Configuration">
- **_name_**: A descriptive name for the task, in this case, "Llama Parse Task".
- **_tools_**: This section lists the tools or integrations being used. Here, `llama_parse` is defined as an integration tool.
</Accordion>

<Accordion title="Tool Configuration">
- **_type_**: Specifies the type of tool, which is `integration` in this context.
- **_integration_**: Details the provider and setup for the integration.
- **_provider_**: Indicates the service provider, which is `llama-parse` for Llama Parse.
- **_setup_**: Contains configuration details, such as the API key (`llamaparse_api_key`) required for authentication.
- **_params_**: Optional setup parameters that can be used to customize the integration.
</Accordion>

<Accordion title="Execution Configuration">
- **_main_**: Defines the main execution steps.
- **_tool_**: Refers to the tool defined earlier (`llama_parse`).
- **_arguments_**: Specifies the input parameters for the tool:
- **_file_**: Can be either a base64 encoded file string or an array of http/https URLs to load
- **_filename_**: (optional) The name of the file (only used with base64 encoded files). Defaults to None.
- **_base64_**: (optional) Whether the input file is base64 encoded. Defaults to false.
- **_params_**: (optional) Optional arguments parameters that can override setup parameters for specific tasks. Defaults to None.
</Accordion>
</AccordionGroup>

<Callout type="info" title="Additional Parameters">
The different parameters available for the Llama Parse integration can be found in the [Llama Parse API documentation](https://github.com/run-llama/llama_parse/blob/main/README.md).
</Callout>

<Note>
Remember to replace `{llamaparse_api_key}` with your actual API key and ensure your file is base64 encoded if `base64` is set to true. Use the `params` field to pass any additional parameters required by your specific use case.
</Note>
<Note>
Llama Parse supports a wide range of different file types. For a full list of supported file types, please refer to the [Llama Parse documentation](https://github.com/run-llama/llama_parse/blob/main/llama_parse/utils.py).
</Note>
## Conclusion

With the Llama Parse integration, you can efficiently process documents and extract valuable information.
This integration provides a robust solution for document processing, enhancing your workflow's capabilities and user experience.

For further assistance, feel free to reach out to our support team or consult the [Llama Parse API documentation](https://docs.cloud.llamaindex.ai/llamaparse/getting_started/python).

<Callout type="success" title="Need Help?">
If you encounter any issues or have questions, our support team is here to help. Don't hesitate to reach out!
</Callout>
Loading

0 comments on commit 0764f3b

Please sign in to comment.