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

# Introduction

> A Job is an assembly of nodes that can be interconnected and evaluated as clusters. This is particularly beneficial for assessing chains and monitoring your system holistically.

# Overview

# Quick Start

<Tabs>
  <Tab title="Python (w/ package)">
    ```python theme={null}
    from helicone.runs import HeliconeJob, HeliconeNode, HeliconeNodeConfig
    from helicone.openai_proxy import openai, Meta

    my_job = HeliconeJob(
        name="My Job",
        description="This job utilizes Helicone",
        custom_properties={
            "hello": "bye"
        }
    )

    create_course_outline = my_job.create_node(
        HeliconeNodeConfig(
            name="My Node",
            description="This node utilizes Helicone",
            custom_properties={
                "topic": topic,
            }
        )
    )

    openai.ChatCompletion.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "user", "content": f"Hello!"}
        ],
        heliconeMeta=Meta(
            node_id=create_course_outline.id,
        )
    )
    ```
  </Tab>

  <Tab title="Node.js (w/ package)">
    Coming soon! Please upvote on our [roadmap](https://github.com/Helicone/helicone/issues/933).
  </Tab>

  <Tab title="cURL">
    **Create a job**

    ```bash theme={null}
    curl --request POST \
    --url https://api.helicone.ai/job \
    --header "Authorization: Bearer $HELICONE_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
    "name": "My Job",
    	"description": "This is my job",
    	"customProperties": {
    		"hello": "world"
    	},
    	"timeoutSeconds": 3600,
    	"status": "PENDING"
    }'
    ```
  </Tab>
</Tabs>

***

# Viewing Jobs

By navigating to [helicone.ai/jobs](https://www.helicone.ai/job), you can view all your jobs along with their current status.

<img src="https://mintcdn.com/helicone/psm-vDV7pnoZSp6H/images/jobs/table.png?fit=max&auto=format&n=psm-vDV7pnoZSp6H&q=85&s=87a4979515d6caf3c90c495ba4f1fcf4" alt="Job table showing all current job statuses on Helicone" width="2716" height="1066" data-path="images/jobs/table.png" />

Clicking on a specific job will redirect you to the job page where you can observe the nodes and their respective status.

This can be viewed in both a list format

<img src="https://mintcdn.com/helicone/psm-vDV7pnoZSp6H/images/jobs/list.png?fit=max&auto=format&n=psm-vDV7pnoZSp6H&q=85&s=8ed1cc5bdd37eefd30ae17dba5c4a726" alt="List format view of job nodes and their status on Helicone" width="1318" height="762" data-path="images/jobs/list.png" />

and a graphical representation

<img src="https://mintcdn.com/helicone/psm-vDV7pnoZSp6H/images/jobs/graph.png?fit=max&auto=format&n=psm-vDV7pnoZSp6H&q=85&s=b72bc6b328e3fd74455016063bd3a915" alt="Graphical representation of job nodes and their status on Helicone" width="3444" height="1996" data-path="images/jobs/graph.png" />

# Roadmap

* [ ] [Node.js SDK](https://github.com/Helicone/helicone/issues/933)
* [ ] [Feedback on Nodes]()
* [ ] [Feedback on Jobs]()
* [ ] [Custom Node Types]()
* [ ] [Enhanced Node Graph]()
* [ ] [OpenTelemetry Integration]()
