API ของ Ultineo Reasoning
รันแอปพลิเคชันในแคตตาล็อกจากซอฟต์แวร์ของคุณเอง API ใช้ JSON ผ่าน HTTPS ยืนยันตัวตนทุกการเรียกใช้ด้วยคีย์โปรเจกต์ และตอบทุกการเรียกใช้ในรูปแบบการตอบกลับเดียวกัน
สร้างขึ้นรอบแอป การรัน และคีย์
- แอป
สร้างแอปจากฟิลด์อินพุตและคำสั่งของแอป จากนั้นแสดงรายการ อ่าน และแก้ไขแอปของคุณ
- Runs and usage
การเรียกใช้ครั้งหนึ่งเริ่มแอปพร้อมข้อมูลอินพุต อีกครั้งหนึ่งอ่านการรันกลับมาพร้อมคำตอบ ส่วนสรุปจะแสดงโทเค็นที่ใช้ในสัปดาห์การเรียกเก็บเงินปัจจุบันและยอดเงินของโทเค็นเหล่านั้น
- คีย์
คีย์โปรเจกต์ที่มีขอบเขตสิทธิ์ วันหมดอายุที่ตั้งได้ตามต้องการ และสถานะที่คุณปิดใช้งานได้
อินเทเกรตได้ทุกที่
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- ในออโตเมชันของคุณ
A script or an automation tool launches a run at each event: a form received, a file dropped.
- จากคำตอบหนึ่งไปอีกคำตอบ
คำตอบจากหนึ่งรอบอาจกลายเป็นฟิลด์ในรอบถัดไป: โค้ดของคุณจะต่อเชื่อมขั้นตอนตามที่ต้องการ
The same run, through the API
Your software sends the application’s identifier and its fields, then reads the run back until it is finished.
สิ่งที่ส่งไป
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} สิ่งที่คุณอ่านย้อนกลับ
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} การยืนยันตัวตนและขอบเขตสิทธิ์
- คีย์แบบ bearer
ส่งคีย์โปรเจกต์ของคุณในเฮดเดอร์ Authorization ของทุกการเรียกใช้ ผ่าน HTTPS เท่านั้น
- จำกัดอยู่ในโปรเจกต์เดียว
คีย์หนึ่งผูกกับโปรเจกต์เดียว และไม่สามารถอ่านหรือเขียนข้อมูลของโปรเจกต์อื่นได้เลย ไม่ว่าคำขอจะเป็นอย่างไร
- จัดเก็บเป็นค่าแฮช
ระบบเก็บไว้เพียงค่าแฮชของคีย์ คีย์จึงแสดงแบบเต็มเพียงครั้งเดียว คีย์ที่สูญหายจะถูกแทนที่ด้วยคีย์ใหม่ และไม่มีการกู้คืน
เริ่มการรันและอ่านคำตอบ
- สร้าง
ระบุชื่อแอปพลิเคชันและใส่ค่าหนึ่งค่าสำหรับแต่ละช่องอินพุต โดยใช้ชื่อฟิลด์ที่แอปพลิเคชันส่งคืนเป็นคีย์
- ติดตาม
การรันเป็นแบบอะซิงโครนัส ให้อ่านการรันซ้ำจนกว่าสถานะจะเป็นเสร็จสิ้นหรือล้มเหลว ทั้งสองสถานะเป็นสถานะสุดท้าย
- อ่าน
การรันที่เสร็จสิ้นจะมีคำตอบ ระยะเวลา และจำนวนโทเค็นอินพุตและเอาต์พุต
The runs your software started, one by one
Every call made through the API appears in the reasonings list, marked API, with its duration and its tokens. Each application shows the identifier your software calls.
รูปแบบการตอบกลับเดียวสำหรับทุกคำตอบ
- สามฟิลด์เดิมเสมอ
ทุกคำตอบมีรหัสสถานะ หัวข้อสั้น ๆ และเนื้อหาการตอบกลับ ทั้งเมื่อสำเร็จและเมื่อล้มเหลว
- ข้อความที่คงที่
ข้อความแจ้งข้อผิดพลาดเป็นสตริงภาษาอังกฤษที่คงที่ ซึ่งระบุขอบเขตสิทธิ์ที่ขาดไปหรือค่าที่ถูกปฏิเสธ
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
การขอรับคีย์
API access is included with Ultineo Reasoning. There is no self-service sign-up: our team opens your project and hands you its first key.
เชื่อมต่อซอฟต์แวร์ของคุณกับ Ultineo Reasoning
บอกเราว่าคุณต้องการทำงานอะไรให้เป็นอัตโนมัติ แล้วเราจะเปิดโปรเจกต์และคีย์ API ของโปรเจกต์ให้คุณ
คำถามเกี่ยวกับ API
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
ไม่ คำสั่งเป็นของเจ้าของแอปพลิเคชัน API จะส่งคืนช่องอินพุต ซึ่งเป็นส่วนที่ผู้เรียกใช้กรอก
การสร้างการรันจะตอบกลับทันทีพร้อมสถานะใหม่ ให้อ่านการรันซ้ำจนกว่าจะเสร็จสิ้นเพื่อรับคำตอบ
ได้ คีย์แต่ละรายการมีขอบเขตสิทธิ์และวันหมดอายุที่ตั้งได้ตามต้องการ และคีย์หนึ่งไม่สามารถสร้างคีย์อื่นที่มีขอบเขตกว้างกว่าของตัวเองได้เลย