Python
import os
from meibel import MeibelClient
from meibel.models import (
CreateSessionRequest,
ExecutionPolicy,
DatasourceView,
TagConstraints,
ToolConfig,
)
client = MeibelClient(api_key=os.environ["MEIBEL_API_KEY"])
execution_policy = ExecutionPolicy(
datasources={
"ds_customer_records": DatasourceView(
tables=TagConstraints(
filter={"region": {"$eq": "us-east"}},
hidden_columns={"customers": ["ssn", "date_of_birth"]},
),
),
},
tools={
"send_email": ToolConfig(
variables={"recipient_domain": {"$eq": "acme.com"}},
),
},
)
request = CreateSessionRequest(
prompt="Help the customer support team investigate billing disputes.",
initial_context={"team": "support", "escalation_level": "tier2"},
max_iterations_per_user_message=10,
message_wait_timeout_seconds=120,
execution_policy_ids=["policy_readonly_customer_data"],
execution_policy=execution_policy,
)
response = client.agents.sessions.create("agent_a1b2c3d4", request)
print(f"Created session: {response.session_id}")import { MeibelClient } from "meibel";
const client = new MeibelClient({ apiKey: process.env.MEIBEL_API_KEY });
const session = await client.agents.sessions.create("agent_support_bot", {
prompt: "Help the customer troubleshoot their billing issue.",
initial_context: {
customer_id: "cust_9f8a7b6c",
plan: "enterprise",
},
max_iterations_per_user_message: 8,
message_wait_timeout_seconds: 120,
execution_policy_ids: ["policy_pii_redaction"],
execution_policy: {
datasources: {
ds_billing_postgres: {
tables: {
hidden_columns: {
invoices: ["internal_notes"],
},
hidden_tables: ["audit_log"],
},
},
ds_knowledge_base: {
documents: {
filter: { document_type: { $eq: "billing_faq" } },
},
},
},
tools: {
refund_processor: {
variables: {
amount: { $lte: 500 },
},
},
},
},
});
console.log(`Created session: ${session.session_id}`);package main
import (
"context"
"fmt"
"os"
v2 "github.com/meibel-ai/meibel-go/v2"
)
func main() {
client := v2.NewClient(v2.WithAPIKey(os.Getenv("MEIBEL_API_KEY")))
resp, err := client.Agents.Sessions.Create(
context.Background(),
"agent_abc123",
&v2.CreateSessionRequest{
Prompt: v2.String("Help the customer troubleshoot their billing issue."),
InitialContext: map[string]any{
"customer_id": "cust_78910",
"account_tier": "enterprise",
},
MaxIterationsPerUserMessage: 10,
MessageWaitTimeoutSeconds: 120,
ExecutionPolicyIds: []string{"policy_readonly_billing"},
ExecutionPolicy: &v2.ExecutionPolicy{
Datasources: map[string]v2.DatasourceView{
"ds_billing_db": {
Tables: &v2.TagConstraints{
Filter: map[string]any{
"region": map[string]any{"$eq": "us-east"},
},
HiddenColumns: map[string][]string{
"customers": {"ssn", "credit_card_number"},
},
},
},
},
Tools: map[string]v2.ToolConfig{
"refund_tool": {
Variables: map[string]any{
"max_amount": map[string]any{"$lte": 500},
},
},
},
},
},
)
if err != nil {
panic(err)
}
fmt.Printf("Created session: %s\n", resp.SessionID)
}curl --request POST \
--url https://api.meibel.ai/v2/agents/{agent_id}/sessions \
--header 'Content-Type: application/json' \
--header 'Meibel-API-Key: <api-key>' \
--data '
{
"prompt": "<string>",
"initial_context": {},
"max_iterations_per_user_message": 20,
"message_wait_timeout_seconds": 259200,
"execution_policy_ids": [
"pol_abc123",
"pol_def456"
],
"execution_policy": {
"datasources": {
"ds_abc123": {
"documents": {
"filter": {
"data_element.__id__": {
"$in": [
"de_abc",
"de_def"
]
}
}
},
"tables": {
"filter": {
"orders.region": {
"$eq": "EU"
},
"table.__name__": {
"$in": [
"orders",
"customers"
]
}
},
"hidden_columns": {
"customers": [
"ssn",
"credit_card"
]
}
}
},
"ds_xyz789": {
"disabled": true
}
},
"tools": {
"send_email": {
"variables": {
"max_attachments": {
"$lte": 3
},
"to": {
"$eq": "support@acme.com"
}
}
},
"web_search": {
"disabled": true
}
}
}
}
'const options = {
method: 'POST',
headers: {'Meibel-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
prompt: '<string>',
initial_context: {},
max_iterations_per_user_message: 20,
message_wait_timeout_seconds: 259200,
execution_policy_ids: ['pol_abc123', 'pol_def456'],
execution_policy: {
datasources: {
ds_abc123: {
documents: {filter: {'data_element.__id__': {$in: ['de_abc', 'de_def']}}},
tables: {
filter: {'orders.region': {$eq: 'EU'}, 'table.__name__': {$in: ['orders', 'customers']}},
hidden_columns: {customers: ['ssn', 'credit_card']}
}
},
ds_xyz789: {disabled: true}
},
tools: {
send_email: {variables: {max_attachments: {$lte: 3}, to: {$eq: 'support@acme.com'}}},
web_search: {disabled: true}
}
}
})
};
fetch('https://api.meibel.ai/v2/agents/{agent_id}/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meibel.ai/v2/agents/{agent_id}/sessions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prompt' => '<string>',
'initial_context' => [
],
'max_iterations_per_user_message' => 20,
'message_wait_timeout_seconds' => 259200,
'execution_policy_ids' => [
'pol_abc123',
'pol_def456'
],
'execution_policy' => [
'datasources' => [
'ds_abc123' => [
'documents' => [
'filter' => [
'data_element.__id__' => [
'$in' => [
'de_abc',
'de_def'
]
]
]
],
'tables' => [
'filter' => [
'orders.region' => [
'$eq' => 'EU'
],
'table.__name__' => [
'$in' => [
'orders',
'customers'
]
]
],
'hidden_columns' => [
'customers' => [
'ssn',
'credit_card'
]
]
]
],
'ds_xyz789' => [
'disabled' => true
]
],
'tools' => [
'send_email' => [
'variables' => [
'max_attachments' => [
'$lte' => 3
],
'to' => [
'$eq' => 'support@acme.com'
]
]
],
'web_search' => [
'disabled' => true
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Meibel-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.post("https://api.meibel.ai/v2/agents/{agent_id}/sessions")
.header("Meibel-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"<string>\",\n \"initial_context\": {},\n \"max_iterations_per_user_message\": 20,\n \"message_wait_timeout_seconds\": 259200,\n \"execution_policy_ids\": [\n \"pol_abc123\",\n \"pol_def456\"\n ],\n \"execution_policy\": {\n \"datasources\": {\n \"ds_abc123\": {\n \"documents\": {\n \"filter\": {\n \"data_element.__id__\": {\n \"$in\": [\n \"de_abc\",\n \"de_def\"\n ]\n }\n }\n },\n \"tables\": {\n \"filter\": {\n \"orders.region\": {\n \"$eq\": \"EU\"\n },\n \"table.__name__\": {\n \"$in\": [\n \"orders\",\n \"customers\"\n ]\n }\n },\n \"hidden_columns\": {\n \"customers\": [\n \"ssn\",\n \"credit_card\"\n ]\n }\n }\n },\n \"ds_xyz789\": {\n \"disabled\": true\n }\n },\n \"tools\": {\n \"send_email\": {\n \"variables\": {\n \"max_attachments\": {\n \"$lte\": 3\n },\n \"to\": {\n \"$eq\": \"support@acme.com\"\n }\n }\n },\n \"web_search\": {\n \"disabled\": true\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meibel.ai/v2/agents/{agent_id}/sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Meibel-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prompt\": \"<string>\",\n \"initial_context\": {},\n \"max_iterations_per_user_message\": 20,\n \"message_wait_timeout_seconds\": 259200,\n \"execution_policy_ids\": [\n \"pol_abc123\",\n \"pol_def456\"\n ],\n \"execution_policy\": {\n \"datasources\": {\n \"ds_abc123\": {\n \"documents\": {\n \"filter\": {\n \"data_element.__id__\": {\n \"$in\": [\n \"de_abc\",\n \"de_def\"\n ]\n }\n }\n },\n \"tables\": {\n \"filter\": {\n \"orders.region\": {\n \"$eq\": \"EU\"\n },\n \"table.__name__\": {\n \"$in\": [\n \"orders\",\n \"customers\"\n ]\n }\n },\n \"hidden_columns\": {\n \"customers\": [\n \"ssn\",\n \"credit_card\"\n ]\n }\n }\n },\n \"ds_xyz789\": {\n \"disabled\": true\n }\n },\n \"tools\": {\n \"send_email\": {\n \"variables\": {\n \"max_attachments\": {\n \"$lte\": 3\n },\n \"to\": {\n \"$eq\": \"support@acme.com\"\n }\n }\n },\n \"web_search\": {\n \"disabled\": true\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"session_id": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Sessions
Create Session
POST
/
agents
/
{agent_id}
/
sessions
Python
import os
from meibel import MeibelClient
from meibel.models import (
CreateSessionRequest,
ExecutionPolicy,
DatasourceView,
TagConstraints,
ToolConfig,
)
client = MeibelClient(api_key=os.environ["MEIBEL_API_KEY"])
execution_policy = ExecutionPolicy(
datasources={
"ds_customer_records": DatasourceView(
tables=TagConstraints(
filter={"region": {"$eq": "us-east"}},
hidden_columns={"customers": ["ssn", "date_of_birth"]},
),
),
},
tools={
"send_email": ToolConfig(
variables={"recipient_domain": {"$eq": "acme.com"}},
),
},
)
request = CreateSessionRequest(
prompt="Help the customer support team investigate billing disputes.",
initial_context={"team": "support", "escalation_level": "tier2"},
max_iterations_per_user_message=10,
message_wait_timeout_seconds=120,
execution_policy_ids=["policy_readonly_customer_data"],
execution_policy=execution_policy,
)
response = client.agents.sessions.create("agent_a1b2c3d4", request)
print(f"Created session: {response.session_id}")import { MeibelClient } from "meibel";
const client = new MeibelClient({ apiKey: process.env.MEIBEL_API_KEY });
const session = await client.agents.sessions.create("agent_support_bot", {
prompt: "Help the customer troubleshoot their billing issue.",
initial_context: {
customer_id: "cust_9f8a7b6c",
plan: "enterprise",
},
max_iterations_per_user_message: 8,
message_wait_timeout_seconds: 120,
execution_policy_ids: ["policy_pii_redaction"],
execution_policy: {
datasources: {
ds_billing_postgres: {
tables: {
hidden_columns: {
invoices: ["internal_notes"],
},
hidden_tables: ["audit_log"],
},
},
ds_knowledge_base: {
documents: {
filter: { document_type: { $eq: "billing_faq" } },
},
},
},
tools: {
refund_processor: {
variables: {
amount: { $lte: 500 },
},
},
},
},
});
console.log(`Created session: ${session.session_id}`);package main
import (
"context"
"fmt"
"os"
v2 "github.com/meibel-ai/meibel-go/v2"
)
func main() {
client := v2.NewClient(v2.WithAPIKey(os.Getenv("MEIBEL_API_KEY")))
resp, err := client.Agents.Sessions.Create(
context.Background(),
"agent_abc123",
&v2.CreateSessionRequest{
Prompt: v2.String("Help the customer troubleshoot their billing issue."),
InitialContext: map[string]any{
"customer_id": "cust_78910",
"account_tier": "enterprise",
},
MaxIterationsPerUserMessage: 10,
MessageWaitTimeoutSeconds: 120,
ExecutionPolicyIds: []string{"policy_readonly_billing"},
ExecutionPolicy: &v2.ExecutionPolicy{
Datasources: map[string]v2.DatasourceView{
"ds_billing_db": {
Tables: &v2.TagConstraints{
Filter: map[string]any{
"region": map[string]any{"$eq": "us-east"},
},
HiddenColumns: map[string][]string{
"customers": {"ssn", "credit_card_number"},
},
},
},
},
Tools: map[string]v2.ToolConfig{
"refund_tool": {
Variables: map[string]any{
"max_amount": map[string]any{"$lte": 500},
},
},
},
},
},
)
if err != nil {
panic(err)
}
fmt.Printf("Created session: %s\n", resp.SessionID)
}curl --request POST \
--url https://api.meibel.ai/v2/agents/{agent_id}/sessions \
--header 'Content-Type: application/json' \
--header 'Meibel-API-Key: <api-key>' \
--data '
{
"prompt": "<string>",
"initial_context": {},
"max_iterations_per_user_message": 20,
"message_wait_timeout_seconds": 259200,
"execution_policy_ids": [
"pol_abc123",
"pol_def456"
],
"execution_policy": {
"datasources": {
"ds_abc123": {
"documents": {
"filter": {
"data_element.__id__": {
"$in": [
"de_abc",
"de_def"
]
}
}
},
"tables": {
"filter": {
"orders.region": {
"$eq": "EU"
},
"table.__name__": {
"$in": [
"orders",
"customers"
]
}
},
"hidden_columns": {
"customers": [
"ssn",
"credit_card"
]
}
}
},
"ds_xyz789": {
"disabled": true
}
},
"tools": {
"send_email": {
"variables": {
"max_attachments": {
"$lte": 3
},
"to": {
"$eq": "support@acme.com"
}
}
},
"web_search": {
"disabled": true
}
}
}
}
'const options = {
method: 'POST',
headers: {'Meibel-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
prompt: '<string>',
initial_context: {},
max_iterations_per_user_message: 20,
message_wait_timeout_seconds: 259200,
execution_policy_ids: ['pol_abc123', 'pol_def456'],
execution_policy: {
datasources: {
ds_abc123: {
documents: {filter: {'data_element.__id__': {$in: ['de_abc', 'de_def']}}},
tables: {
filter: {'orders.region': {$eq: 'EU'}, 'table.__name__': {$in: ['orders', 'customers']}},
hidden_columns: {customers: ['ssn', 'credit_card']}
}
},
ds_xyz789: {disabled: true}
},
tools: {
send_email: {variables: {max_attachments: {$lte: 3}, to: {$eq: 'support@acme.com'}}},
web_search: {disabled: true}
}
}
})
};
fetch('https://api.meibel.ai/v2/agents/{agent_id}/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meibel.ai/v2/agents/{agent_id}/sessions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prompt' => '<string>',
'initial_context' => [
],
'max_iterations_per_user_message' => 20,
'message_wait_timeout_seconds' => 259200,
'execution_policy_ids' => [
'pol_abc123',
'pol_def456'
],
'execution_policy' => [
'datasources' => [
'ds_abc123' => [
'documents' => [
'filter' => [
'data_element.__id__' => [
'$in' => [
'de_abc',
'de_def'
]
]
]
],
'tables' => [
'filter' => [
'orders.region' => [
'$eq' => 'EU'
],
'table.__name__' => [
'$in' => [
'orders',
'customers'
]
]
],
'hidden_columns' => [
'customers' => [
'ssn',
'credit_card'
]
]
]
],
'ds_xyz789' => [
'disabled' => true
]
],
'tools' => [
'send_email' => [
'variables' => [
'max_attachments' => [
'$lte' => 3
],
'to' => [
'$eq' => 'support@acme.com'
]
]
],
'web_search' => [
'disabled' => true
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Meibel-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.post("https://api.meibel.ai/v2/agents/{agent_id}/sessions")
.header("Meibel-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"<string>\",\n \"initial_context\": {},\n \"max_iterations_per_user_message\": 20,\n \"message_wait_timeout_seconds\": 259200,\n \"execution_policy_ids\": [\n \"pol_abc123\",\n \"pol_def456\"\n ],\n \"execution_policy\": {\n \"datasources\": {\n \"ds_abc123\": {\n \"documents\": {\n \"filter\": {\n \"data_element.__id__\": {\n \"$in\": [\n \"de_abc\",\n \"de_def\"\n ]\n }\n }\n },\n \"tables\": {\n \"filter\": {\n \"orders.region\": {\n \"$eq\": \"EU\"\n },\n \"table.__name__\": {\n \"$in\": [\n \"orders\",\n \"customers\"\n ]\n }\n },\n \"hidden_columns\": {\n \"customers\": [\n \"ssn\",\n \"credit_card\"\n ]\n }\n }\n },\n \"ds_xyz789\": {\n \"disabled\": true\n }\n },\n \"tools\": {\n \"send_email\": {\n \"variables\": {\n \"max_attachments\": {\n \"$lte\": 3\n },\n \"to\": {\n \"$eq\": \"support@acme.com\"\n }\n }\n },\n \"web_search\": {\n \"disabled\": true\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meibel.ai/v2/agents/{agent_id}/sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Meibel-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prompt\": \"<string>\",\n \"initial_context\": {},\n \"max_iterations_per_user_message\": 20,\n \"message_wait_timeout_seconds\": 259200,\n \"execution_policy_ids\": [\n \"pol_abc123\",\n \"pol_def456\"\n ],\n \"execution_policy\": {\n \"datasources\": {\n \"ds_abc123\": {\n \"documents\": {\n \"filter\": {\n \"data_element.__id__\": {\n \"$in\": [\n \"de_abc\",\n \"de_def\"\n ]\n }\n }\n },\n \"tables\": {\n \"filter\": {\n \"orders.region\": {\n \"$eq\": \"EU\"\n },\n \"table.__name__\": {\n \"$in\": [\n \"orders\",\n \"customers\"\n ]\n }\n },\n \"hidden_columns\": {\n \"customers\": [\n \"ssn\",\n \"credit_card\"\n ]\n }\n }\n },\n \"ds_xyz789\": {\n \"disabled\": true\n }\n },\n \"tools\": {\n \"send_email\": {\n \"variables\": {\n \"max_attachments\": {\n \"$lte\": 3\n },\n \"to\": {\n \"$eq\": \"support@acme.com\"\n }\n }\n },\n \"web_search\": {\n \"disabled\": true\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"session_id": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Path Parameters
Body
application/json
IDs of stored ExecutionPolicies to compose into this session.
Example:
["pol_abc123", "pol_def456"]
Inline session-level access constraints (hardrails). Controls which datasources and tools the agent can use, and what data is accessible within each. Composed with any stored policies referenced by execution_policy_ids.
Show child attributes
Show child attributes
Example:
{
"datasources": {
"ds_abc123": {
"documents": {
"filter": {
"data_element.__id__": { "$in": ["de_abc", "de_def"] }
}
},
"tables": {
"filter": {
"orders.region": { "$eq": "EU" },
"table.__name__": { "$in": ["orders", "customers"] }
},
"hidden_columns": { "customers": ["ssn", "credit_card"] }
}
},
"ds_xyz789": { "disabled": true }
},
"tools": {
"send_email": {
"variables": {
"max_attachments": { "$lte": 3 },
"to": { "$eq": "support@acme.com" }
}
},
"web_search": { "disabled": true }
}
}
Response
Successful Response
Was this page helpful?