Sébastien Han
c91e3552a3
feat: implementation for agent/session list and describe ( #1606 )
...
Create a new agent:
```
curl --request POST \
--url http://localhost:8321/v1/agents \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"agent_config": {
"sampling_params": {
"strategy": {
"type": "greedy"
},
"max_tokens": 0,
"repetition_penalty": 1
},
"input_shields": [
"string"
],
"output_shields": [
"string"
],
"toolgroups": [
"string"
],
"client_tools": [
{
"name": "string",
"description": "string",
"parameters": [
{
"name": "string",
"parameter_type": "string",
"description": "string",
"required": true,
"default": null
}
],
"metadata": {
"property1": null,
"property2": null
}
}
],
"tool_choice": "auto",
"tool_prompt_format": "json",
"tool_config": {
"tool_choice": "auto",
"tool_prompt_format": "json",
"system_message_behavior": "append"
},
"max_infer_iters": 10,
"model": "string",
"instructions": "string",
"enable_session_persistence": false,
"response_format": {
"type": "json_schema",
"json_schema": {
"property1": null,
"property2": null
}
}
}
}'
```
Get agent:
```
curl http://127.0.0.1:8321/v1/agents/9abad4ab-2c77-45f9-9d16-46b79d2bea1f
{"agent_id":"9abad4ab-2c77-45f9-9d16-46b79d2bea1f","agent_config":{"sampling_params":{"strategy":{"type":"greedy"},"max_tokens":0,"repetition_penalty":1.0},"input_shields":["string"],"output_shields":["string"],"toolgroups":["string"],"client_tools":[{"name":"string","description":"string","parameters":[{"name":"string","parameter_type":"string","description":"string","required":true,"default":null}],"metadata":{"property1":null,"property2":null}}],"tool_choice":"auto","tool_prompt_format":"json","tool_config":{"tool_choice":"auto","tool_prompt_format":"json","system_message_behavior":"append"},"max_infer_iters":10,"model":"string","instructions":"string","enable_session_persistence":false,"response_format":{"type":"json_schema","json_schema":{"property1":null,"property2":null}}},"created_at":"2025-03-12T16:18:28.369144Z"}%
```
List agents:
```
curl http://127.0.0.1:8321/v1/agents |jq
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 1680 100 1680 0 0 498k 0 --:--:-- --:--:-- --:--:-- 546k
{
"data": [
{
"agent_id": "9abad4ab-2c77-45f9-9d16-46b79d2bea1f",
"agent_config": {
"sampling_params": {
"strategy": {
"type": "greedy"
},
"max_tokens": 0,
"repetition_penalty": 1.0
},
"input_shields": [
"string"
],
"output_shields": [
"string"
],
"toolgroups": [
"string"
],
"client_tools": [
{
"name": "string",
"description": "string",
"parameters": [
{
"name": "string",
"parameter_type": "string",
"description": "string",
"required": true,
"default": null
}
],
"metadata": {
"property1": null,
"property2": null
}
}
],
"tool_choice": "auto",
"tool_prompt_format": "json",
"tool_config": {
"tool_choice": "auto",
"tool_prompt_format": "json",
"system_message_behavior": "append"
},
"max_infer_iters": 10,
"model": "string",
"instructions": "string",
"enable_session_persistence": false,
"response_format": {
"type": "json_schema",
"json_schema": {
"property1": null,
"property2": null
}
}
},
"created_at": "2025-03-12T16:18:28.369144Z"
},
{
"agent_id": "a6643aaa-96dd-46db-a405-333dc504b168",
"agent_config": {
"sampling_params": {
"strategy": {
"type": "greedy"
},
"max_tokens": 0,
"repetition_penalty": 1.0
},
"input_shields": [
"string"
],
"output_shields": [
"string"
],
"toolgroups": [
"string"
],
"client_tools": [
{
"name": "string",
"description": "string",
"parameters": [
{
"name": "string",
"parameter_type": "string",
"description": "string",
"required": true,
"default": null
}
],
"metadata": {
"property1": null,
"property2": null
}
}
],
"tool_choice": "auto",
"tool_prompt_format": "json",
"tool_config": {
"tool_choice": "auto",
"tool_prompt_format": "json",
"system_message_behavior": "append"
},
"max_infer_iters": 10,
"model": "string",
"instructions": "string",
"enable_session_persistence": false,
"response_format": {
"type": "json_schema",
"json_schema": {
"property1": null,
"property2": null
}
}
},
"created_at": "2025-03-12T16:17:12.811273Z"
}
]
}
```
Create sessions:
```
curl --request POST \
--url http://localhost:8321/v1/agents/{agent_id}/session \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"session_name": "string"
}'
```
List sessions:
```
curl http://127.0.0.1:8321/v1/agents/9abad4ab-2c77-45f9-9d16-46b79d2bea1f/sessions |jq
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 263 100 263 0 0 90099 0 --:--:-- --:--:-- --:--:-- 128k
[
{
"session_id": "2b15c4fc-e348-46c1-ae32-f6d424441ac1",
"session_name": "string",
"turns": [],
"started_at": "2025-03-12T17:19:17.784328"
},
{
"session_id": "9432472d-d483-4b73-b682-7b1d35d64111",
"session_name": "string",
"turns": [],
"started_at": "2025-03-12T17:19:19.885834"
}
]
```
Signed-off-by: Sébastien Han <seb@redhat.com>
2025-05-07 14:49:23 +02:00