AI Tools & Function Calling

You can give LLMs (like OpenAI GPT-4o, Anthropic Claude 3.5 Sonnet, or Gemini) the ability to send emails and inspect delivery statuses through structured tool/function calling.

OpenAI Function Calling Example

Define the sending tool schema:

import OpenAI from "openai";
import { Mailofly } from "mailofly";

const openai = new OpenAI();
const mailofly = new Mailofly(process.env.MAILOFLY_API_KEY!);

const emailTools: OpenAI.ChatCompletionTool[] = [
  {
    type: "function",
    function: {
      name: "send_email",
      description: "Send an email to a user via Mailofly.",
      parameters: {
        type: "object",
        properties: {
          to: { type: "string", description: "Recipient email address" },
          subject: { type: "string", description: "Subject line of the email" },
          body: { type: "string", description: "HTML content of the email" },
        },
        required: ["to", "subject", "body"],
      },
    },
  },
];

Executing the Function Call

async function handleToolCall(toolCall: OpenAI.ChatCompletionMessageToolCall) {
  if (toolCall.function.name === "send_email") {
    const args = JSON.parse(toolCall.function.arguments);
    const result = await mailofly.emails.send({
      from: "AI Assistant <assistant@yourdomain.com>",
      to: args.to,
      subject: args.subject,
      html: args.body,
    });
    return JSON.stringify(result);
  }
}

⌘I