Quickstart

curl https://api.allternit.com/v1/accounts \
  -H "Authorization: Bearer $ALLTERNIT_API_KEY" -H "Content-Type: application/json" \
  -d '{ "name": "Lakeside Dental" }'

import { AllternitPlatform } from "@allternit/platform";

const client = new AllternitPlatform(); // reads ALLTERNIT_API_KEY
const account = await client.accounts.create({ name: "Lakeside Dental" });

from allternit_platform import AllternitPlatform

client = AllternitPlatform()  # reads ALLTERNIT_API_KEY
account = client.accounts.create(name="Lakeside Dental")

curl https://api.allternit.com/v1/agents \
  -H "Authorization: Bearer $ALLTERNIT_API_KEY" -H "Content-Type: application/json" \
  -d '{ "account_id": "acct_7Hq…", "name": "Front desk",
        "instructions": "Answer questions about Lakeside Dental and book cleanings." }'

const agent = await client.agents.create({
  account_id: account.id,
  name: "Front desk",
  instructions: "Answer questions about Lakeside Dental and book cleanings.",
});

agent = client.agents.create(
    account_id=account["id"],
    name="Front desk",
    instructions="Answer questions about Lakeside Dental and book cleanings.",
)

curl https://api.allternit.com/v1/agents/agent_3f9…/conversations \
  -H "Authorization: Bearer $ALLTERNIT_API_KEY" -H "Content-Type: application/json" -d '{}'

const conversation = await client.conversations.create(agent.id);

conversation = client.conversations.create(agent["id"])

curl https://api.allternit.com/v1/conversations/conv_81c…/messages \
  -H "Authorization: Bearer $ALLTERNIT_API_KEY" -H "Content-Type: application/json" \
  -d '{ "content": "Can I book a cleaning next Tuesday?" }'

const reply = await client.conversations.sendMessage(conversation.id, {
  content: "Can I book a cleaning next Tuesday?",
});
console.log(reply.content);

reply = client.conversations.send_message(
    conversation["id"], content="Can I book a cleaning next Tuesday?"
)
print(reply["content"])

curl -N https://api.allternit.com/v1/conversations/conv_81c…/messages \
  -H "Authorization: Bearer $ALLTERNIT_API_KEY" -H "Content-Type: application/json" \
  -d '{ "content": "What should I bring?", "stream": true }'

const stream = client.conversations.stream(conversation.id, { content: "What should I bring?" });
for await (const event of stream) {
  if (event.type === "message.delta") process.stdout.write(event.delta);
}
const stored = await stream.finalMessage();

from allternit_platform import MessageDelta

stream = client.conversations.stream(conversation["id"], content="What should I bring?")
for event in stream:
    if isinstance(event, MessageDelta):
        print(event.delta, end="", flush=True)
stored = stream.final_message