pica/os: A New Standard for AI Task Execution
Revolutionize your workflows with structured, smart AI automation that balances efficiency and control.
Key Concepts
Intention
Clearly defined goals for AI tasks, ensuring precise understanding and execution. Examples include 'Respond to customer inquiry' or 'Update client record'.
Payload
Structured data necessary for task completion, including all relevant information like customer details, inquiry type, and history to ensure accurate and efficient AI action.
Alignment Level
A scale from 0 to 3 determining the level of user involvement required, balancing automation with user control for different types of tasks and decisions.
How pica/os Works
A Structured Approach to AI Task Execution
When an agent is deployed in pica/os, it is equipped with a clear intention, a specific role, and tasks assigned to it—just like a human employee. The agents work autonomously on these tasks, accessing the necessary tools and actions while planning future work, like follow-ups and rechecks.
These agents blend AI efficiency with human oversight seamlessly. They take on routine operations autonomously, notify users for approvals or adjustments when needed, and ensure smooth integration of AI-driven capabilities with human decision-making.
Intention
The intention defines the specific goal or action the AI needs to perform. For example, “Respond to customer inquiry” tells the AI exactly what needs to be done.
Example:
“Respond to customer inquiry about product pricing”
Role & Task Assignment
Each agent is assigned a specific role and tasks that fit their expertise. These agents work like human employees, understanding their responsibilities and executing tasks based on their role.
Example Roles:
- Customer Support Agent
- Sales Assistant
- Data Analyst
Alignment Level
The alignment level indicates the degree of user involvement required, ranging from 0 (no approval needed) to 3 (full user involvement).
Level 0: Autonomous execution
Level 1: Review required
Code Example
1import { Agent } from "@picaos/agent";
2import { ticketing, email, calendar, crm } from "@picaos/actions";
3import { listConnections } from "@picaos/connections";
4
5// Connections can be managed via @picaos/authKit or the pica/os dashboard
6// pica/os takes care of OAuth and API keys for you and secures your data
7const connections = await listConnections(); // List all connections
8
9// Select the actions you want to use
10const actions = [
11 ticketing.read(), // 🤔 Read tickets from connected ticketing system like Zendesk, Jira, etc.
12 ticketing.update({ alignment: "auto" }), // 📝 Update tickets in connected ticketing system
13 email.send({ alignment: "require-approval" }), // 📧 Send an email via connected email provider like Gmail, etc.
14 calendar.create(), // 📅 Create a calendar event via connected calendar provider like Google Calendar, etc.
15 calendar.update(), // 📅 Update a calendar event via connected calendar provider like Google Calendar, etc.
16 crm.all(), // 📊 Read & Write to all models from connected CRM like Hubspot, Salesforce, etc.
17];
18
19// Configure the agent
20const config = {
21 name: "Customer Support Agent",
22 systemPrompt: "You are a helpful assistant that can manage customer tickets.",
23 alignment: "auto",
24 model: "gpt-4o",
25 actions,
26 connections,
27 interval: 1000 * 60 * 10, // 10 minutes
28 maxDuration: 1000 * 60 * 60 * 24 * 7, // 7 days
29};
30
31// Initialize the agent with actions
32// The agent is initialized with full access to your configured actions and connections
33// It can seamlessly interact with all authorized services and APIs
34const agent = new Agent(config);
35
36// Create tasks via code or manage them on the pica/os dashboard
37await agent.addTask("Manage all open customer tickets and follow up until resolved.");
38
39// Start the agent
40await agent.start();
41
42// Agent handles everything from creating responses to scheduling follow-ups.
43// It also triggers tasks to recheck tickets every 10 minutes to ensure continuous operation.
44Benefits of pica/os
Efficiency
Automate routine tasks and streamline complex processes, allowing your team to focus on high-value activities.
Control
Maintain oversight on critical decisions with customizable alignment levels, ensuring the right balance of automation and human input.
Scalability
Easily scale your operations by deploying AI agents to handle increasing workloads without compromising on quality or responsiveness.
Consistency
Ensure consistent execution of tasks and processes across your organization, reducing errors and improving overall quality.