使用Postman调用Llama Agents工作流的技术指南

在Llama Agents项目中，开发者通常使用官方提供的llamaClient来调用工作流和服务。然而在实际开发过程中，我们经常需要使用Postman这样的API测试工具来进行接口调试。本文将详细介绍如何通过Postman直接调用Llama Agents的工作流API。

准备工作

首先需要确保已经启动了Llama Agents的控制平面(Control Plane)和目标工作流。控制平面默认会运行在本地8000端口，可以通过访问控制平面的Swagger文档界面来查看所有可用的API接口。

API调用流程

Llama Agents的API调用遵循两个主要步骤：

1. 创建会话(Session)

   • 请求方法：POST
   • 端点：/api/sessions/
   • 请求体：可以留空或根据需求添加特定参数

2. 执行工作流

   • 请求方法：POST
   • 端点：/api/workflows/{workflow_name}/run
   • 请求头：需要包含上一步获取的session_id
   • 请求体：根据工作流需求提供相应的输入参数

具体操作示例

假设我们要调用名为"my_workflow"的工作流：

1. 首先创建会话：

   POST http://127.0.0.1:8000/api/sessions/
   

2. 获取响应中的session_id，例如：

   {
     "session_id": "abc123-def456-ghi789"
   }
   

3. 使用该session_id调用工作流：

   POST http://127.0.0.1:8000/api/workflows/my_workflow/run
   Headers:
     "session_id": "abc123-def456-ghi789"
   Body:
   {
     "input_param1": "value1",
     "input_param2": "value2"
   }
   

注意事项

1. 确保控制平面和工作流服务都已正确启动并运行
2. 检查端口号是否正确，如果不是默认的8000端口需要相应调整
3. 工作流名称需要与部署时使用的名称完全一致
4. 某些工作流可能需要特定的输入参数格式，建议先通过Swagger文档了解接口规范

通过以上步骤，开发者可以方便地使用Postman测试Llama Agents的工作流，这对于调试和集成测试非常有帮助。相比直接使用客户端代码，这种方式提供了更灵活的测试手段，特别适合在开发初期验证工作流逻辑。