Skip to main content

Overview

This section provides practical examples of using ATP for various use cases. Each example includes complete, runnable code.

Example Categories


Quick Examples

Minimal Tool

from atp_sdk.clients import ToolKitClient

client = ToolKitClient(
    api_key="YOUR_ATP_TOOLKIT_API_KEY",
    app_name="my_app"
)

@client.register_tool(
    function_name="echo",
    params=['text'],
    required_params=['text'],
    description="Echoes the input text.",
    auth_provider=None,
    auth_type=None,
    auth_with=None
)
def echo(**kwargs):
    return {"echo": kwargs.get('text')}

client.start()

Tool with OAuth2

import requests
from atp_sdk.clients import ToolKitClient

client = ToolKitClient(
    api_key="YOUR_ATP_TOOLKIT_API_KEY",
    app_name="hubspot_toolkit"
)

@client.register_tool(
    function_name="get_contacts",
    params=[],
    required_params=[],
    description="Fetches contacts from HubSpot.",
    auth_provider="hubspot",
    auth_type="OAuth2",
    auth_with="access_token"
)
def get_contacts(**kwargs):
    access_token = kwargs.get('auth_token')
    url = "https://api.hubapi.com/crm/v3/objects/contacts"
    headers = {"Authorization": f"Bearer {access_token}"}
    response = requests.get(url, headers=headers)
    return response.json()

client.start()

LLM Integration (OpenAI)

import openai
from atp_sdk.clients import LLMClient

openai_client = openai.OpenAI(api_key="YOUR_OPENAI_API_KEY")
llm_client = LLMClient(api_key="YOUR_ATP_LLM_CLIENT_API_KEY")

# Get toolkit context
context = llm_client.get_toolkit_context(
    toolkit_id="your_toolkit_id",
    provider="openai",
    user_prompt="Say hello to Alice."
)

# Generate tool calls
response = openai_client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Say hello to Alice."}
    ],
    tools=context["tools"],
    tool_choice="auto"
)

tool_calls = response.choices[0].message.tool_calls

# Execute tool calls
if tool_calls:
    result = llm_client.call_tool(
        toolkit_id="your_toolkit_id",
        tool_calls=tool_calls,
        provider="openai",
        user_prompt="Say hello to Alice."
    )
    print(result)

Browse Examples