Propose a learning from an edit
curl --request POST \
--url https://api.getoneprofile.ai/agent-learnings/hand-edits/ \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subject": {
"kind": "hand_edit",
"target": {
"outbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"target_kind": "task",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
}
'import requests
url = "https://api.getoneprofile.ai/agent-learnings/hand-edits/"
payload = {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subject": {
"kind": "hand_edit",
"target": {
"outbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"target_kind": "task",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
subject: {
kind: 'hand_edit',
target: {
outbound_message_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
target_kind: 'task',
task_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
}
}
})
};
fetch('https://api.getoneprofile.ai/agent-learnings/hand-edits/', 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.getoneprofile.ai/agent-learnings/hand-edits/",
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([
'request_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'subject' => [
'kind' => 'hand_edit',
'target' => [
'outbound_message_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'target_kind' => 'task',
'task_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getoneprofile.ai/agent-learnings/hand-edits/"
payload := strings.NewReader("{\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"subject\": {\n \"kind\": \"hand_edit\",\n \"target\": {\n \"outbound_message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"target_kind\": \"task\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getoneprofile.ai/agent-learnings/hand-edits/")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"subject\": {\n \"kind\": \"hand_edit\",\n \"target\": {\n \"outbound_message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"target_kind\": \"task\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getoneprofile.ai/agent-learnings/hand-edits/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"subject\": {\n \"kind\": \"hand_edit\",\n \"target\": {\n \"outbound_message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"target_kind\": \"task\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"action": "added",
"agent_name": "<string>",
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"learning": {
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"created_by_user_id": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"source": "table_cells",
"text": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"all_sequences": false,
"note": "<string>",
"note_surface": "table_cells",
"noted_at": "2023-11-07T05:31:56Z",
"notes": [
"<string>"
],
"repeats": 0,
"source_text": "<string>",
"step_key": "<string>",
"step_label": "<string>"
},
"previous_text": "<string>",
"redo": {
"detail": "<string>",
"state": "none"
},
"subject_key": "<string>",
"surface": "table_cells",
"more": [
{
"action": "added",
"learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"previous_text": "<string>",
"text": "<string>"
}
],
"proposal": {
"auto_rewrites": 123,
"changes": [
{
"find": "<string>",
"history": [
{
"find": "<string>",
"note": 123,
"replace_with": "<string>",
"text": "<string>"
}
],
"id": "<string>",
"kind": "add",
"note": 123,
"off": true,
"outcome": "applied",
"points": [
123
],
"question": "<string>",
"replace_with": "<string>",
"replaces_scope": "sequence",
"replaces_text": "<string>",
"saved_learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "sequence",
"step_label": "<string>",
"text": "<string>",
"words": 123
}
],
"learn_detail": "<string>",
"learn_state": "ok",
"moved_from_text": "<string>",
"points": [
{
"covered": true,
"goes_to": "rule",
"note": 123,
"number": 123,
"quote": "<string>",
"reason": "<string>",
"said": "<string>"
}
],
"replaces_scope": "sequence",
"replaces_text": "<string>",
"rev": 123,
"saved_learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "sequence",
"text": "<string>"
}
}{
"action": "added",
"agent_name": "<string>",
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"learning": {
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"created_by_user_id": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"source": "table_cells",
"text": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"all_sequences": false,
"note": "<string>",
"note_surface": "table_cells",
"noted_at": "2023-11-07T05:31:56Z",
"notes": [
"<string>"
],
"repeats": 0,
"source_text": "<string>",
"step_key": "<string>",
"step_label": "<string>"
},
"previous_text": "<string>",
"redo": {
"detail": "<string>",
"state": "none"
},
"subject_key": "<string>",
"surface": "table_cells",
"more": [
{
"action": "added",
"learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"previous_text": "<string>",
"text": "<string>"
}
],
"proposal": {
"auto_rewrites": 123,
"changes": [
{
"find": "<string>",
"history": [
{
"find": "<string>",
"note": 123,
"replace_with": "<string>",
"text": "<string>"
}
],
"id": "<string>",
"kind": "add",
"note": 123,
"off": true,
"outcome": "applied",
"points": [
123
],
"question": "<string>",
"replace_with": "<string>",
"replaces_scope": "sequence",
"replaces_text": "<string>",
"saved_learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "sequence",
"step_label": "<string>",
"text": "<string>",
"words": 123
}
],
"learn_detail": "<string>",
"learn_state": "ok",
"moved_from_text": "<string>",
"points": [
{
"covered": true,
"goes_to": "rule",
"note": 123,
"number": 123,
"quote": "<string>",
"reason": "<string>",
"said": "<string>"
}
],
"replaces_scope": "sequence",
"replaces_text": "<string>",
"rev": 123,
"saved_learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "sequence",
"text": "<string>"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>",
"issues": [
{
"input": "<string>",
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}agent-learnings
Propose a learning from an edit
Propose a learning from a person’s own edit of one message the agent wrote: a Tasks card’s words, a follow-up or Builder message not sent yet, one contact’s own words for a step in the Builder, or a reply draft. The edit is already kept (each place saves its own words); this reads the words before and after on the server and proposes what the agent should do differently, with the notes of any proposal waiting on the message, which it replaces. Nothing is written again. It is saved only by the page’s yes (Approve, Looks good or sending the reply, or POST /agent-learnings/thumbs-downs/{event_id}/commit/), sharpened by a further note (POST /agent-learnings/thumbs-downs/ with the same hand_edit subject), and dropped by Discard feedback (POST /agent-learnings/thumbs-downs/{event_id}/revert/), which keeps the edit. Words back as the agent wrote them, or changed only in spacing, call no model: a learning proposed from an earlier edit is dismissed and answered with 200, otherwise it is refused. Sent again with the same request_id, it answers what the first one did. Only a signed-in person can, never an API key.
POST
/
agent-learnings
/
hand-edits
/
Propose a learning from an edit
curl --request POST \
--url https://api.getoneprofile.ai/agent-learnings/hand-edits/ \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subject": {
"kind": "hand_edit",
"target": {
"outbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"target_kind": "task",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
}
'import requests
url = "https://api.getoneprofile.ai/agent-learnings/hand-edits/"
payload = {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subject": {
"kind": "hand_edit",
"target": {
"outbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"target_kind": "task",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
subject: {
kind: 'hand_edit',
target: {
outbound_message_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
target_kind: 'task',
task_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
}
}
})
};
fetch('https://api.getoneprofile.ai/agent-learnings/hand-edits/', 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.getoneprofile.ai/agent-learnings/hand-edits/",
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([
'request_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'subject' => [
'kind' => 'hand_edit',
'target' => [
'outbound_message_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'target_kind' => 'task',
'task_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getoneprofile.ai/agent-learnings/hand-edits/"
payload := strings.NewReader("{\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"subject\": {\n \"kind\": \"hand_edit\",\n \"target\": {\n \"outbound_message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"target_kind\": \"task\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getoneprofile.ai/agent-learnings/hand-edits/")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"subject\": {\n \"kind\": \"hand_edit\",\n \"target\": {\n \"outbound_message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"target_kind\": \"task\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getoneprofile.ai/agent-learnings/hand-edits/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"subject\": {\n \"kind\": \"hand_edit\",\n \"target\": {\n \"outbound_message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"target_kind\": \"task\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"action": "added",
"agent_name": "<string>",
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"learning": {
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"created_by_user_id": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"source": "table_cells",
"text": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"all_sequences": false,
"note": "<string>",
"note_surface": "table_cells",
"noted_at": "2023-11-07T05:31:56Z",
"notes": [
"<string>"
],
"repeats": 0,
"source_text": "<string>",
"step_key": "<string>",
"step_label": "<string>"
},
"previous_text": "<string>",
"redo": {
"detail": "<string>",
"state": "none"
},
"subject_key": "<string>",
"surface": "table_cells",
"more": [
{
"action": "added",
"learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"previous_text": "<string>",
"text": "<string>"
}
],
"proposal": {
"auto_rewrites": 123,
"changes": [
{
"find": "<string>",
"history": [
{
"find": "<string>",
"note": 123,
"replace_with": "<string>",
"text": "<string>"
}
],
"id": "<string>",
"kind": "add",
"note": 123,
"off": true,
"outcome": "applied",
"points": [
123
],
"question": "<string>",
"replace_with": "<string>",
"replaces_scope": "sequence",
"replaces_text": "<string>",
"saved_learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "sequence",
"step_label": "<string>",
"text": "<string>",
"words": 123
}
],
"learn_detail": "<string>",
"learn_state": "ok",
"moved_from_text": "<string>",
"points": [
{
"covered": true,
"goes_to": "rule",
"note": 123,
"number": 123,
"quote": "<string>",
"reason": "<string>",
"said": "<string>"
}
],
"replaces_scope": "sequence",
"replaces_text": "<string>",
"rev": 123,
"saved_learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "sequence",
"text": "<string>"
}
}{
"action": "added",
"agent_name": "<string>",
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"learning": {
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"created_by_user_id": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"source": "table_cells",
"text": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"all_sequences": false,
"note": "<string>",
"note_surface": "table_cells",
"noted_at": "2023-11-07T05:31:56Z",
"notes": [
"<string>"
],
"repeats": 0,
"source_text": "<string>",
"step_key": "<string>",
"step_label": "<string>"
},
"previous_text": "<string>",
"redo": {
"detail": "<string>",
"state": "none"
},
"subject_key": "<string>",
"surface": "table_cells",
"more": [
{
"action": "added",
"learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"previous_text": "<string>",
"text": "<string>"
}
],
"proposal": {
"auto_rewrites": 123,
"changes": [
{
"find": "<string>",
"history": [
{
"find": "<string>",
"note": 123,
"replace_with": "<string>",
"text": "<string>"
}
],
"id": "<string>",
"kind": "add",
"note": 123,
"off": true,
"outcome": "applied",
"points": [
123
],
"question": "<string>",
"replace_with": "<string>",
"replaces_scope": "sequence",
"replaces_text": "<string>",
"saved_learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "sequence",
"step_label": "<string>",
"text": "<string>",
"words": 123
}
],
"learn_detail": "<string>",
"learn_state": "ok",
"moved_from_text": "<string>",
"points": [
{
"covered": true,
"goes_to": "rule",
"note": 123,
"number": 123,
"quote": "<string>",
"reason": "<string>",
"said": "<string>"
}
],
"replaces_scope": "sequence",
"replaces_text": "<string>",
"rev": 123,
"saved_learning_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "sequence",
"text": "<string>"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>",
"issues": [
{
"input": "<string>",
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}Authorizations
APIKeyHeaderHTTPBearer
Body
application/json
Propose a learning from a person's own edit of one message the agent wrote.
Response
The words are back as the agent wrote them: the learning proposed from an earlier edit is dismissed, and proposal is null.
What a thumbs down did.
added a learning, or updated one about the same thing.
Available options:
added, updated, split, carried, skipped, seeded, session, deleted The agent that learned it.
The thumbs down, for Undo.
The learning as written; null on a replay whose learning was deleted since.
Show child attributes
Show child attributes
What the updated learning said before; null for an added one.
How the redo a thumbs down asked for went.
Show child attributes
Show child attributes
What the thumbs down was given on, as list_thumbs_downs takes it, so a screen that gave it elsewhere (the AI Assistant's card) can follow its note.
Where it was given; hand_edit for a learning a person's own edit proposed, whose card dismisses it and keeps the edit.
Available options:
table_cells, agent_preview, task, writing_preview, reply_draft, sent_message, hand_edit, simplified, carried, template, hand A table agent's other learnings it wrote, one for each other point the reason made, in order; empty when it made one. Always empty on an outbound message, whose changes proposal.changes lists. Undo takes them all back.
Show child attributes
Show child attributes
The feedback session it opened or refined: the changes it proposes, not saved yet; learning is null then. A further thumbs down on the same message, cells or Preview example refines it (the latest note wins). Null on a replay of a session saved or thrown away since.
Show child attributes
Show child attributes
Was this page helpful?