@picahq/toolkit

Pica ToolKit

Pica's ToolKit provides enterprise-grade integration capabilities for AI agents built with the Vercel AI SDK. Through Pica's integration layer, agents can seamlessly interact with third-party services and APIs while maintaining enterprise security, compliance, and reliability standards.

Installation

npm install @picahq/toolkit

Setup

• Create a new Pica account
• Create a Connection via the Pica Dashboard
• Create a Pica API key
• Set the API key as an environment variable: PICA_SECRET_KEY=<your-api-key>

Usage

The Pica ToolKit seamlessly integrates with Vercel AI SDK, enabling powerful AI capabilities in your applications. Below is a simple example showing how to implement it in a Vercel Agent with read-only permissions on a Gmail connection.

import { Pica } from '@picahq/toolkit';
import { openai } from '@ai-sdk/openai';
import {
  streamText,
  UIMessage,
  convertToModelMessages,
  stepCountIs
} from 'ai';

export async function POST(req: Request) {
  const { messages }: { messages: UIMessage[] } = await req.json();

  const pica = new Pica(process.env.PICA_SECRET_KEY!, {
    connectors: ["test::gmail::default::6faf1d3707f846ef89295c836df71c94"],
    permissions: "read"
  });

  const systemPrompt = pica.systemPrompt;

  const result = streamText({
    model: openai("gpt-4.1"),
    messages: convertToModelMessages(messages),
    tools: {
      ...pica.tools() // Load the Pica ToolKit
    },
    system: systemPrompt,
    stopWhen: stepCountIs(25)
  });

  return result.toUIMessageStreamResponse();
}

⭐️ Experience the Pica ToolKit's capabilities firsthand through our interactive demo chat application here

What can Pica do?

After installing the SDK and integrating your platforms through the Pica dashboard, you can effortlessly create sophisticated AI agents to orchestrate and automate your business workflows.

Here are some powerful examples use cases:

Communication & Productivity

• Compose and send Gmail emails containing meeting summaries to team members
• Schedule Google Calendar events with specified date/time parameters
• Post messages with campaign analytics to designated Slack channels
• Search and retrieve Q3 planning materials from Google Drive

Data Access & Analysis

• Execute PostgreSQL queries to identify top customer segments
• Generate new Google Sheets workbooks populated with sales metrics
• Retrieve closing opportunity data from Salesforce CRM
• Maintain project tracking databases in Notion workspaces

Business Operations

• Create customer support cases in Zendesk from feedback data
• Process customer refund transactions via Stripe
• Convert website inquiries into HubSpot lead entries
• Generate client invoices through QuickBooks integration

AI & Content

• Create DALL-E images matching product requirements
• Convert meeting audio to text using ElevenLabs
• Conduct market research via Tavily/SerpApi integrations
• Perform sentiment analysis on support interactions

License

This project is licensed under the GPL-3.0 license. See the LICENSE file for details.