使用说明
Deltaton API和数据源文档
Deltaton平台提供了两种主要的交互方式，以及网络和移动应用程序。
- REST（或MCP）API -用于通过HTTP请求与Deltaton交互的REST API接口。
- 数据馈送 -通过WebSocket将实时数据流（馈送数据）传输到Deltaton，实现平台上的直接代理交互。
基本URL
https://api.deltaton.com
代理类型
Deltaton支持2种专用代理类型。当端点需要 agentType 在请求体中的属性中，使用以下值之一：
| 代理类型 | 描述 | 常见用例 |
|---|---|---|
general |
概述 | 广泛的农业查询，基础农场管理 |
myfarm-<FarmID> |
您的农场 | 为您的农场量身定制的建议 |
使用web应用程序创建农场，并在农场页面上获取您的农场ID。
数据馈送
数据馈送系统允许通过WebSocket连接向Deltaton平台实时传输数据。这些数据可作为代理响应的上下文，从而实现更准确和个性化的建议。
数据馈送入门
- 在以下网址创建Deltaton帐户https://deltaton.com
- 联系Deltaton支持(support@deltaton.com)接收您的：
token-WebSocket身份验证所需userId-您的唯一标识符
馈送数据结构
馈送数据存储在具有以下结构的MongoDB文档中：
{
<agentType>: <Your Data>
}
数据馈送和更新的工作方式类似于更新MongoDB文档中的数据。每次向Deltaton平台提供数据时，您都会收到一个响应，其中包含以下格式的所有存储数据：
{
success: true,
message: 'Feed data received successfully',
data: {
'myfarm-6929b996627f55b365431319': {
temperature: 27,
humidity: 14,
lastUpdatedAt: '2025-10-19T19:36:45.797Z' // This is generated by the system.
}
}
}
WebSocket连接
要与Deltaton建立WebSocket连接，请包含以下必需的标头：
token:DeltaFeed <your-token>-您的唯一身份验证令牌userId:your-userId-您的Deltaton用户标识符
有关完整的实现示例，请参阅我们的示例代码：
- TypeScript示例
- Python示例
- 或者使用我们的Python SDK deltaton_feed_py 数据库 以便轻松地将数据馈送到Deltaton平台。
这些示例演示了如何建立WebSocket连接并将数据流式传输到Deltaton平台。
REST API文档
Deltaton平台为不同的农业领域提供了专门的人工智能代理。每个代理都在自己的聊天会话中运行，允许集中交互和个性化推荐。要开始使用代理，首先创建一个专用会话，然后通过该会话进行对话。
身份验证标头
对API的所有HTTPS请求都需要以下身份验证头：
Content-Type: application/json-指定JSON格式的请求deltaton-id: <your-mcp-id>-您的唯一MCP标识符deltaton-key: <your-mcp-key>-您的MCP身份验证密钥
重要：处理API请求可能需要长达10秒的时间。相应地配置客户端超时设置。
获取您的 deltaton-id 和 deltaton-key 凭据，请联系我们的支持团队support@deltaton.com.
支持的语言
Deltaton提供跨这些语言的多语言支持：
| 英语 | 西班牙语 | 法语 | 德语 | 意大利语 | 葡萄牙语 | 俄语 | 波兰语 | 匈牙利语 |
|---|---|---|---|---|---|---|---|---|
en |
es |
fr |
de |
it |
pt |
ru |
pl |
hu |
| 捷克语 | 斯洛伐克语 | 荷兰语 | 乌克兰语 | 罗马尼亚语 | 希腊语 |
|---|---|---|---|---|---|
cs |
sk |
nl |
uk |
ro |
gr |
当提出要求时 lang 参数（如发送消息），使用相应的语言代码指定所需的语言。
例子： { "prompt": "Hello", "lang": "en" }
REST API端点
重要
在开始使用端点之前，请对项目进行结构化，以便首先创建会话，然后在该会话中发送消息。每个新消息请求都必须包含会话ID(_id)作为URL中的路径参数。我们建议为每个代理创建单独的会话。例如，如果您使用的是General Agent，请先创建其会话，然后将该会话用于所有后续消息。
1.创建会话
POST /api/mcp/sessions
这将为指定的代理创建一个新会话，并返回创建的会话。你需要 _id 属性向此会话发送消息。
请求正文
| 财产 | 价值 |
|---|---|
name |
会话名称。如果没有提供，它将被设置为“新会话”。 |
agentType |
请参考上表设置代理类型。 |
回应
{
_id: '78f15682ba76159d9c57fabc',
userId: '01ABCED16GYCCKJA06EKCFEB84',
name: 'New Session',
agentType: 'general',
createdAt: '2025-10-16T20:33:06.544Z',
}
2.发送消息
POST /api/mcp/{sessionId}/messages
这将为指定会话创建一条新消息。
请求正文
| 财产 | 价值 |
|---|---|
prompt |
（必填）您想向代理人提出的问题。 |
agentType |
（必需）必须是上面列出的受支持的代理类型之一。 |
context |
（可选）任何其他数据上下文，可以是字符串化的JSON、纯文本或Markdown文本（推荐），包括表格。对于JSON数据，使用明确的属性名（例如。 {temperature: 25} 而不是 {t: 25}). |
lang |
（可选）问题和回答的语言代码。必须是上面列出的支持语言之一。如果未提供，则默认为“en”。 |
回应
{
id: <Unique Message ID>,
sessionId: <Unique Session ID the message belongs to>,
content: <The AI response in markdown format>,
direction: <SENT or RECEIVED>,
state: <The message status>,
createdAt: <UTC timestamp the message was created>
}
请按会话ID对邮件进行分组，并按 createdAt 如果您计划实现聊天界面，请使用时间戳。
重要说明
- 如果数据值发生更改，我们建议在每次请求时提供额外的数据作为上下文，或者每10个消息提供一次，因为代理的内存限制为10条消息。
- 响应内容采用Markdown格式，您可能需要根据您的开发环境来呈现它。
