Skip to main content

Check out Port for yourself 

Port AI Assistant

Closed Beta

Port's AI offerings are currently in closed beta and will be gradually rolled out to users by the end of 2025.

The Port AI Assistant is the fastest way to start using AI with Port - no configuration required. Available through a floating chat button, it provides instant, intelligent answers about your software catalog, actions, and Port's capabilities.

What is the Port AI Assistant?​

The Port AI Assistant is an out-of-the-box chat interface that:

  • Requires no setup: Start asking questions immediately without defining agents or configurations.
  • Always accessible: Available through a floating button whenever you have access to Port AI.
  • Comprehensive knowledge: Understands your catalog, actions, and Port documentation.
  • Safe by default: Uses read-only MCP tools and approval mode for actions.
  • Fastest experience: Get answers without the customization overhead of AI Agents.

Built on Port AI, the assistant operates using Port AI's developer tools in safe mode - meaning all actions run in approval mode (you get a link to review and execute) and uses read-only tools for data queries. The assistant also has access to Port's documentation through a dedicated MCP tool.

How to Use the Port AI Assistant​

The Port AI Assistant is available through a floating chat button in the Port interface. Simply click the button at the bottom-right corner to open the chat interface and start asking questions.

Once you ask a question, the assistant analyzes your request and uses the appropriate tools to provide a comprehensive response.

After processing your request, you'll receive a detailed answer along with any relevant actions or next steps.

Example Questions​

The Port AI Assistant can help with a wide variety of questions out of the box:

Service Ownership & Information
  • "Who owns the payment service?"
  • "What services does the platform team own?"
  • "Show me all microservices owned by the Backend team"
  • "What is the checkout service about?"
  • "What are the dependencies of the OrderProcessing service?"
Deployment & Operations
  • "How do I deploy the auth service to production?"
  • "When was the last successful deployment of the payment service?"
  • "Show me failed deployments from last week"
  • "What's deployed in production today?"
  • "What's the deployment frequency of team X?"
Quality & Compliance
  • "Which services are failing security checks?"
  • "Give me a weekly summary of open bugs"
  • "What's preventing the InventoryService from reaching Gold level?"
  • "Show me services with high bug counts"
  • "What's our overall security score?"
Incidents & Monitoring
  • "Show me active incidents"
  • "Which services had an incident in the last 30 days?"
  • "Who is on call for the payment service?"
  • "What is our mean time to resolution?"
Tasks & Workflow
  • "What tasks are assigned to me?"
  • "Show me my urgent Jira tickets"
  • "How many issues were closed by the frontend team this month?"
  • "What PRs are waiting for my review?"
Port Usage & Help
  • "How do I create a new blueprint?"
  • "What's the best way to set up scorecards?"
  • "How can I trigger an action via API?"
  • "Show me how to configure RBAC permissions"

Security & Permissions​

The Port AI Assistant respects your organization's security controls:

  • RBAC compliance: Only accesses data you have permissions to view.
  • Safe operation: Read-only tools for data queries.
  • Action approval: All actions require your explicit approval before execution.
  • Audit trail: All interactions are logged as AI invocations.
  • Access control: Access to the Port AI Assistant is controlled through the _ai_invocation blueprint permissions. Learn more about controlling access to Port AI.

For comprehensive security information, see AI Security and Data Controls.

Frequently Asked Questions​

Do I need to configure anything to use the Port AI Assistant? (Click to expand)

No! The Port AI Assistant works out of the box. As soon as you have access to Port AI, you can start asking questions through the floating chat button. No setup, no configuration, no agent definitions required.

Can the Port AI Assistant run actions on my behalf? (Click to expand)

The assistant can help you execute actions, but it operates in approval mode. This means:

  1. It will identify the right action for your request
  2. It will populate the action parameters based on context
  3. It will provide you a link to review and complete the action
  4. You maintain full control over execution

This approach ensures safety while making actions easier to discover and use.

What's the difference between Port AI Assistant and AI Agents? (Click to expand)

Port AI Assistant is designed for:

  • Immediate use with zero configuration
  • General-purpose questions across your entire catalog
  • Interactive exploration and ad-hoc queries
  • Human interaction and learning

AI Agents are designed for:

  • Domain-specific expertise and workflows
  • Machine-to-machine communication
  • Autonomous operations and automations
  • Customized behavior for specific use cases

The assistant is the fastest way to get started, while agents provide advanced customization for specialized needs.

What data can the Port AI Assistant access? (Click to expand)

The assistant uses Port AI's developer tools, which include read-only access to your data model, entities, scorecards, self-service actions, and Port documentation. All data access respects your organization's RBAC policies - you can only access data you have permissions to view. Learn more about Port AI's security controls.

Can the Port AI Assistant help me learn how to use Port? (Click to expand)

Yes! The assistant has comprehensive knowledge of Port's documentation and can help you:

  • Understand how features work
  • Learn best practices
  • Troubleshoot issues
  • Discover new capabilities

Try asking questions like "How do I create a blueprint?" or "What's the best way to set up scorecards?"

When should I use the Port AI Assistant vs other AI interfaces? (Click to expand)

Use the Port AI Assistant when you want immediate AI access with zero configuration. It's perfect for quick questions, exploratory queries, learning Port, and ad-hoc analysis.

Use AI Chat Widgets (with AI Agents) when you need customized AI experiences embedded in dashboards - configure prompts, conversation starters, and specific tool selections for team-specific workflows.

Use AI Agents for domain-specific expertise, machine-to-machine communication, and autonomous operations that require advanced customization.

Are there usage limits for the Port AI Assistant? (Click to expand)

Yes, the Port AI Assistant uses the same usage limits as Port AI. These limits are at the organization level and include hourly rate limits and monthly quotas.

Monitor your usage through AI invocations in your Port catalog.