POST
/
interactions
import { ProficientClient } from "@proficient/client";

const proficient = new ProficientClient({
  apiKey: process.env.PROFICIENT_AI_PUBLISHABLE_KEY,
  userExternalId: "...", // The user's unique ID in your system
});

const agentId = "ag_Lad8YCGGiDLiqIZPWRXmc2ix";

const { interaction } = await proficient.interactions.create({ agentId });

{
  "interaction": {
    "id": "<string>",
    "object": "interaction",
    "agent_id": "<string>",
    "archived": true,
    "created_at": 123,
    "initial_turn": "user",
    "name": "<string>",
    "total_message_count": 123,
    "updated_at": 123,
    "user_id": "<string>"
  },
  "messages": [
    {
      "id": "<string>",
      "object": "message",
      "content": "<string>",
      "created_at": 123,
      "depth": 123,
      "interaction_id": "<string>",
      "parent_id": "<string>",
      "sent_by": "user"
    }
  ]
}
import { ProficientClient } from "@proficient/client";

const proficient = new ProficientClient({
  apiKey: process.env.PROFICIENT_AI_PUBLISHABLE_KEY,
  userExternalId: "...", // The user's unique ID in your system
});

const agentId = "ag_Lad8YCGGiDLiqIZPWRXmc2ix";

const { interaction } = await proficient.interactions.create({ agentId });

Body

application/json

The data with which an interaction is created.

​
agent_id
string
required

The unique identifier of the agent

Response

200
application/json

An object that contains the initial interaction data including the Interaction object itself and the initial messages associated with it.

​
interaction
object
required
<p>Users communicate with agents via <i>interactions</i>. You can think of each interaction as a conversation between an agent and user.</p>
​
messages
object[]
required
<p>Each interaction holds a number of <i>messages</i> and every message belongs to an interaction. The `sent_by` property of a message indicates whether a message was created by an agent or a user.</p>
List all interactionsRetrieve an interaction