Tools Integration

Tools transform your knowledge agents from passive information providers into active problem solvers. By integrating specialized capabilities, your agents can perform tasks, retrieve real-time data, make calculations, and connect to enterprise systems—all while maintaining the conversational experience users expect.

What Are Tools?

In Prisme.ai, tools are specialized functions that extend an agent’s capabilities beyond retrieving and presenting information from your knowledge base. They allow agents to:

Perform Actions

Execute tasks based on user requests

Access Live Data

Retrieve real-time information from external systems

Process Information

Perform calculations, transformations, and analysis

Integrate with Systems

Connect with enterprise applications and services

Tool Types

Prisme.ai supports several types of tools, each with specific purposes and capabilities:

Built-in tools provided by Prisme.ai, ready to use with minimal configuration.

Common Tools

Prisme.ai includes a growing library of native tools that you can add to your agents with minimal configuration:

Web Search

Enable your agent to search the web for current information beyond your knowledge base.Capabilities: Real-time web search with configurable sourcesUse Cases: Current events, market data, general knowledgeConfiguration Options: Search providers (Google, Bing, DuckDuckGo), result filtering, result count, safe search settings, domain restrictionsExample Implementation:

- YourWebSearch.search:
    query: "{{input.text}}"
    provider: "google"
    resultCount: 5
    safeSearch: true
    output: searchResults
- set:
    name: output
    value:
      value: "{{searchResults}}"
      description: "Web search results for: {{input.text}}"

Code Interpreter

Image Generator

Document Search

Search through document collections using keywords and filters.Capabilities: Text search across document repositoriesUse Cases: Knowledge retrieval, research assistance, content discoveryExample Implementation:

- MyAgent.listDocuments:
    page: 0
    limit: 20
    filters:
      - field: content
        type: textSearch
        value: "{{body.arguments.keywords}}"
    includeContent: true
    provider: crawler
    output: documents
    includeMetadata: true
- set:
    name: output
    value:
      value: "{{documents}}"
      description: "documents using the keyword search: {{body.arguments.keywords}}"

Query Reformulation

Generate alternative phrasings of user questions to improve search results.Capabilities: Create semantic variations of input questionsUse Cases: Search enhancement, query expansion, intent clarificationExample Implementation:

- MyAgent.chat-completion:
    messages:
      - role: assistant
        content: Given the following user question, generate 3 alternative phrasings that express the same intent. Return the result as a JSON object with a "reformulations" key.
      - role: user
        content: 'Question: "{{user_question}}"'
    output: reformulations
- set:
    name: output
    value:
      value: "{{reformulations}}"
      description: alternative phrasings of user question

Creating Custom Tools

You can create custom tools to address specific needs in your organization:

Define Tool Requirements

Determine what the tool should do and how it should interact with users and systems.Consider:

What problem does this tool solve?
What inputs will it need?
What outputs should it provide?
Which systems will it interact with?
What security considerations are important?

Select Tool Type

Choose the most appropriate tool type based on your requirements.Tool selection guidance:

Use native tools for common functions
Choose custom code for specialized logic
Select API connectors for external service integration
Use webhooks for complex process orchestration
Implement database tools for structured data queries

Configure or Develop the Tool

Set up the tool’s parameters or develop its code.For custom development:

Create clear input/output schemas
Implement robust error handling
Ensure appropriate security measures
Test with various input scenarios
Document the tool’s functionality

Test the Tool

Verify that the tool works as expected in different scenarios.Testing should include:

Basic functionality verification
Edge case handling
Performance assessment
Security testing
Integration testing with agent

Add to Your Agent

Integrate the tool with your knowledge agents.During integration:

Provide clear tool descriptions
Configure when the tool should be used
Set appropriate permissions
Define error handling behavior
Test the agent with the new tool

Tool Usage Strategies

Effective tool integration requires thoughtful configuration of when and how tools are used:

Tool Selection Logic

User Confirmation

Tool Result Presentation

Fallback Handling

Integration Examples

Agent Purpose: Answer product questions and resolve customer issuesIntegrated Tools:

Ticket Creator: Create support tickets for complex issues
Order Lookup: Check order status and details
Product Catalog: Access current product information
Document Analyzer: Process customer documents and screenshots
Email Composer: Send confirmation and follow-up emails

Benefits:

Streamlined issue resolution
Reduced handoffs between systems
Consistent information across channels

Security and Governance

Ensuring secure and responsible tool usage is critical:

Authentication & Authorization

Configure secure access to tools and their underlying systems.Key Controls:

Tool-specific permissions

API key management

Credential rotation

User-based access control

Data Privacy

Ensure tools handle sensitive information appropriately.Key Controls:

Data minimization

Information redaction

Temporary storage policies

Privacy-preserving integration

Logging & Auditing

Maintain records of tool usage for compliance and security.Key Controls:

Comprehensive activity logs

Tool usage analytics

Audit trails

Anomaly detection

Rate Limiting & Quotas

Prevent abuse and manage resource consumption.Key Controls:

Usage quotas

Rate limiting

Cost controls

Resource allocation

Best Practices

Tool Selection

Tool Configuration

User Experience

Tool Management

Next Steps

Agent Testing

Learn how to test and validate your tool-enabled agents

Advanced RAG

Combine tools with advanced RAG techniques

RAG Configuration

Configure how tools interact with your knowledge base

Analytics

Monitor tool usage and performance

Overview

AI SecureChat

AI Store

AI Knowledge

AI Builder

AI Governance

AI Collection (beta)

AI Insights (beta)

What Are Tools?

Perform Actions

Access Live Data

Process Information

Integrate with Systems

Tool Types

Common Tools

Creating Custom Tools

Tool Usage Strategies

Integration Examples

Security and Governance

Authentication & Authorization

Data Privacy

Logging & Auditing

Rate Limiting & Quotas

Best Practices

Next Steps

Agent Testing

Advanced RAG

RAG Configuration

Analytics

Overview

AI SecureChat

AI Store

AI Knowledge

AI Builder

AI Governance

AI Collection (beta)

AI Insights (beta)

​What Are Tools?

Perform Actions

Access Live Data

Process Information

Integrate with Systems

​Tool Types

​Common Tools

​Creating Custom Tools

​Tool Usage Strategies

​Integration Examples

​Security and Governance

Authentication & Authorization

Data Privacy

Logging & Auditing

Rate Limiting & Quotas

​Best Practices

​Next Steps

Agent Testing

Advanced RAG

RAG Configuration

Analytics

What Are Tools?

Tool Types

Common Tools

Creating Custom Tools

Tool Usage Strategies

Integration Examples

Security and Governance

Best Practices

Next Steps