For complex tasks, Grok may need to call multiple tools across several turns. A conversation loop handles this automatically.

Why Use a Conversation Loop?

Some queries require multiple tool calls. For example, "Summarize my emails and add important ones to my task list" might require:

1. Fetching emails
2. Reading email contents
3. Creating tasks

A loop handles these multi-step interactions automatically.

Implementing a Conversation Loop

Here's a robust conversation loop that handles multiple tool call rounds:

await metorial.withProviderSession(
  metorialXai,
  { serverDeployments: ['your-server-deployment-id'] },
  async session => {
    let messages = [
      {
        role: 'user',
        content: 'Summarize the README.md file of the metorial/websocket-explorer repository on GitHub.'
      }
    ];

    // Deduplicate tools by name to avoid conflicts
    let uniqueTools = Array.from(
      new Map(session.tools.map(t => [t.function.name, t])).values()
    );

    // Allow up to 10 iterations
    for (let i = 0; i < 10; i++) {
      let response = await xai.chat.completions.create({
        model: 'grok-beta',
        messages,
        tools: uniqueTools
      });

      let choice = response.choices[0];
      let toolCalls = choice.message.tool_calls;

      // If no more tools needed, we have our final answer
      if (!toolCalls || toolCalls.length === 0) {
        console.log(choice.message.content);
        return;
      }

      // Execute the tools and add results to history
      let toolResponses = await session.callTools(toolCalls);
      messages.push(
        { role: 'assistant', tool_calls: toolCalls },
        ...toolResponses
      );
    }

    throw new Error('No final response received after 10 iterations');
  }
);

Best Practices

• Set a maximum iteration limit to prevent infinite loops
• Deduplicate tools if you encounter naming conflicts
• Handle the final response when no tool calls are returned
• Log iterations during development to understand the flow

Error Handling

Always wrap your loop in try-catch to handle errors gracefully:

try {
  // ... conversation loop ...
} catch (error) {
  console.error('Conversation failed:', error);
}